From benzolius at yahoo.com  Thu Jul 18 11:38:16 2013
From: benzolius at yahoo.com (Benedek Zoltan)
Date: Thu, 18 Jul 2013 02:38:16 -0700 (PDT)
Subject: [Doc-SIG] broken link?
Message-ID: <1374140296.21347.YahooMailNeo@web121601.mail.ne1.yahoo.com>

Hi,

The link on http://docs.python.org/2.7/genindex-S.html

under

sys
??? module

returns:

http://docs.python.org/2.7/c-api/intro.html#index-20

Is this intended or is a broken link?

Regards
Zoli
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/doc-sig/attachments/20130718/d6e8104e/attachment.html>

From fuzzyman at voidspace.org.uk  Sat Jul 20 23:52:55 2013
From: fuzzyman at voidspace.org.uk (Michael Foord)
Date: Sun, 21 Jul 2013 00:52:55 +0300
Subject: [Doc-SIG] broken link?
In-Reply-To: <1374140296.21347.YahooMailNeo@web121601.mail.ne1.yahoo.com>
References: <1374140296.21347.YahooMailNeo@web121601.mail.ne1.yahoo.com>
Message-ID: <E2F6C0D5-01FC-4BF0-B15A-15071B5B18D2@voidspace.org.uk>


On 18 Jul 2013, at 12:38, Benedek Zoltan <benzolius at yahoo.com> wrote:

> Hi,
> 
> The link on http://docs.python.org/2.7/genindex-S.html
> 
> under
> 
> sys
>     module
> 
> returns:
> 
> http://docs.python.org/2.7/c-api/intro.html#index-20
> 
> Is this intended or is a broken link?

Looking at the sphinx docs source that does seem to be a deliberate back reference, but I'm not sure of the value of the index reference to the word 'module' there. It is a confusing entry in the index.

Michael

> 
> Regards
> Zoli
> _______________________________________________
> Doc-SIG maillist  -  Doc-SIG at python.org
> http://mail.python.org/mailman/listinfo/doc-sig


--
http://www.voidspace.org.uk/


May you do good and not evil
May you find forgiveness for yourself and forgive others
May you share freely, never taking more than you give.
-- the sqlite blessing 
http://www.sqlite.org/different.html






From grubert at users.sourceforge.net  Mon Jul 22 10:33:43 2013
From: grubert at users.sourceforge.net (engelbert gruber)
Date: Mon, 22 Jul 2013 10:33:43 +0200
Subject: [Doc-SIG] docutils release 0.11 out
Message-ID: <CAHnbgBNmwW_B+ZF77uH7VgkbiNCW3msaoCVRjozVTbgO22mVuA@mail.gmail.com>

hello ,

I finally got around to release, PLEASE report anything failings to me.

summary of changes since 0.10

* General

  - Apply [ 2714873 ] Fix for the overwritting of document attributes.
  - Support embedded aliases within hyperlink references.
  - Fix [ 228 ] try local import of docutils components (reader, writer, parser,
    language module) before global search.

* docutils/parsers/rst/directives/tables.py

  - Fix [ 210 ] Python 3.3 checks CVS syntax only if "strict" is True.

* docutils/writers/html4css1/__init__.py
  - Fix [ 3600051 ] for tables in a list, table cells are not compacted.
  - New setting `stylesheet_dirs` (see above).

    Now, it is easy to add a custom stylesheet to Docutils' default
    stylesheet with, e.g., ``--stylesheet_path='html4css1.css, mystyle.css'``

    Changed behaviour of the default settings:
      if there is a file ``html4css1.css`` in the working directory of the
      process at launch, it is used instead of the one provided by Docutils
      in the writer source directory.

  - New default for math-output_: ``HTML math.css``.
  - Avoid repeated class declarations in html4css1 writer
    (modified version of patch [ 104 ]).

.. _math-output: docs/user/config.html#math-output

* docutils/writers/latex2e/__init__.py

  - Drop the simple algorithm replacing straight double quotes with
    English typographic ones.
    Activate the SmartQuotes_ transform if you want this feature.
  - New setting `stylesheet_dirs`: Comma-separated list of directories
    where stylesheets are found. Used by `stylesheet_path` when expanding
    relative path arguments.

.. _SmartQuotes: docs/user/config.html#smart-quotes

* docutils/writers/manpage.py

  - Fix [3607063] handle lines starting with a period.
  - Fix option separating comma was bold (thanks to Bill Morris).

all the best
  engelbert