[Doc-SIG] References in the same line as the target text

[Simon Budig]

Simon Budig (Simon.Budig@unix-ag.uni-siegen.de) wrote:
[named links are hard to maintain]

[David:]
> > That's exactly why anonymous links were introduced.
> 
> This essentially boils down to "Ok, named links are hard to use, so we
> introduced anonymous links. They are hard to maintain too, but a little
> less."
> 
> So to use links in reST I have the choice between two evil things:
> 1) make sure that Link targets and Link text are absolutely the same
> 2) count "__"s.
> 
> This is exactly why I proposed a third solution  :-)

Just to show the uglyness of anonymous and named links: This is from the
webpage source (as in CVS):

*snip*

Project Links
=============

- `Project Summary page`__: `released files`__, `bug reports`__,
  patches__, `mailing lists`__, and news__.
- `Docutils CVS repository`__
- Project coordinator and architect: `David Goodger`_
- Please direct discussions to the `Python Documentation Special
  Interest Group (Doc-SIG)`__: doc-sig@python.org.
- Powered by |Python|__
- Hosted by |SourceForge|__

  __ http://sourceforge.net/projects/docutils/
  __ `project files page`_
  __ http://sourceforge.net/tracker/?group_id=38414&atid=422030
  __ http://sourceforge.net/tracker/?group_id=38414&atid=422032
  __ http://sourceforge.net/mail/?group_id=38414
  __ http://sourceforge.net/news/?group_id=38414

  __ CVS_

  __ Doc-SIG_

  __ http://www.python.org/
  .. |Python| image:: PyBanner016.png
  .. :border: 0

  __ http://sourceforge.net/
  .. |SourceForge| image::
     http://sourceforge.net/sflogo.php?group_id=38414
     :alt: SourceForge Logo
  .. :border: 0

.. _project files page:
   http://sourceforge.net/project/showfiles.php?group_id=38414
.. _Anonymous CVS access: http://sourceforge.net/cvs/?group_id=38414
.. _CVS:
.. _browse the CVS repository:
   http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/docutils/
.. _To Do list: spec/notes.html#to-do
.. _README: README.html
.. _HISTORY: HISTORY.html
.. _master repository: http://www.python.org/peps/
.. _mailto:
.. _David Goodger: mailto:goodger@users.sourceforge.net
.. _Doc-SIG: http://www.python.org/sigs/doc-sig/

*snip*

Please don't try to tell me that a newbie easily finds the URL for
`Docutils CVS repository`__


Bye,
        Simon
-- 
      Simon.Budig@unix-ag.org       http://www.home.unix-ag.org/simon/