Use the ``\\\\url`` command for URLs

(breaks long URLs instead of writing into the margin).

git-svn-id: http://svn.code.sf.net/p/docutils/code/trunk@6183 929543f6-e4f2-0310-98a6-ba3bd3dd1d04

1 files changed, 23 insertions, 51 deletions

diff --git a/docutils/docs/dev/todo.txt b/docutils/docs/dev/todo.txt
index 739375198..14308e6e5 100644
--- a/docutils/docs/dev/todo.txt
+++ b/docutils/docs/dev/todo.txt
@@ -2029,6 +2029,10 @@ Which packages do we want to use?
      :bigfoot: texlive-latex-extra
      :footnote: texlive-latex-recommended
      :perpage: texlive-latex-extra
+     :ftnxtra: new on CTAN
+	       fixes the issue of footnote inside \caption{},
+	       tabular environment and \section{} like commands.
+
 
   .. Footnote FAQs:
 
@@ -2263,70 +2267,38 @@ Ideas:
     -1 prevents passing of options to the "ucs" package.
 
 
-wrapping URLs
-`````````````
-
-Hyperlinks are not hyphenated; this leads to bad spacing. See
-docs/user/rst/demo.txt 2.14 directives.
-
-See the thread "LaTeX writer: trouble with URLs" at docutils-devel and
-http://www.tex.ac.uk/cgi-bin/texfaq2html?label=breaklinks
-
-Use \url to typeset URLs. With hyperref,
-
-*    \nolinkurl    is an alias for the url package's \url
-*    \url          is equivalent to \href{URL}{\nolinkurl{URL}}.
-
-I don't think we need special support for the 'deception' case
-`NAME <URL1>`_ with NAME != URL1 and NAME a valid URL.
-
-Detection
-^^^^^^^^^
-
-* Test <reference> nodes for ``node[refuri] == node.astext()``
+problematic URLs
+````````````````
 
-* Apply also to the content of the "uri-reference" role (once it is
-  implemented).
+* ^^ LaTeX's special syntax for characters results in "strange" replacements
+  (both with \href and \url).
 
-(Do we need an additional test with Docutils' default detection mechanism
-states.Inliner.patterns.uri ?)
+  `file with ^^ <../strange^^name>`__:
+  `<../strange^^name>`__
 
+* Unbalanced braces, { or }, will fail (both with \href and \url)::
 
-Layout/Font
-^^^^^^^^^^^
+    `file with { <../strange{name>`__
+    `<../strange{name>`__
 
-We could ensure the same look as currently (normal text font for URLs) with
-``\urlstyle{same}``, but I would stick to the LaTeX default and document the
-configuration options.
+Currently, a warning is written to the error output stream.
 
-Fragility
-^^^^^^^^^
+For correct printing, we can
 
-   The "\url" command is fragile, and its argument is likely to be very
-   fragile, but a defined-url is robust:
+* use the \href command with "normal" escaped name argument, or
+* define a url-command in the preamble ::
 
-As \url is a very special, ``verb``-like command, escaping does not always
-work.
-
-We need to check the conditions:
-
-   If the argument contains any "%", "#", or "^^", or ends with "\", it
-   can't be used in the argument to another command. The argument must not
-   contain unbalanced braces.
-
-Escaping works for # and %::
+    \urldef{\fragileURLi}\nolinkurl{myself%node@gateway.net}
 
-   \footnote{siehe \url{http://www.w3.org/XML/Schema\#dev}}
-   \footnote{siehe \url{http://example.org/Schema\%dev}}
+but need to find a way to insert it as href argument.
 
-For "^^", we can define a url-command in the preamble ::
+The following fails::
 
-    \urldef{\fragileURLi}\nolinkurl{myself%node@gateway.net}
+    \href{http://www.w3.org/XML/Schema^^dev}{\fragileURLi}
 
-but need to find a way to insert it as href argument, as the following fails
-::
+Use %-replacement like http://nowhere/url_with%28parens%29 ?
 
-    \href{http://www.w3.org/XML/Schema^^dev}{\fragileURLi}
+-> does not work for file paths (with pdflatex and xpdf).
 
 
 add-stylesheet option