From 4d8a87d3bb93eb19dc3f9c05719b648ef07cff23 Mon Sep 17 00:00:00 2001
From: goodger <goodger@929543f6-e4f2-0310-98a6-ba3bd3dd1d04>
Date: Sat, 11 Mar 2006 01:35:01 +0000
Subject: [PATCH] added Jim Fulton's idea for adaptable extensions on
 hyperlinks

git-svn-id: https://docutils.svn.sourceforge.net/svnroot/docutils/trunk@4401 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
---
 docutils/docs/dev/todo.txt | 45 ++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 44 insertions(+), 1 deletion(-)

diff --git a/docutils/docs/dev/todo.txt b/docutils/docs/dev/todo.txt
index ebf83904b..2c136fc72 100644
--- a/docutils/docs/dev/todo.txt
+++ b/docutils/docs/dev/todo.txt
@@ -839,7 +839,7 @@ __ rst/alternatives.html#or-not-to-do
 
   What is to be done for output formats that don't *have* hyperlinks?
   For example, LaTeX targeted at print.  Hyperlinks may be "called
-  out", as footnotes with explicit URLs.
+  out", as footnotes with explicit URLs.  (Don't convert the links.)
 
   But then there's also LaTeX targeted at PDFs, which *can* have
   links.  Perhaps a runtime setting for "*" could explicitly provide
@@ -865,6 +865,49 @@ __ rst/alternatives.html#or-not-to-do
   __ http://thread.gmane.org/gmane.text.docutils.user/1915
   __ http://thread.gmane.org/gmane.text.docutils.user/2438
 
+  Idea from Jim Fulton: an external lookup table of targets:
+
+      I would like to specify the extension (e.g. .txt) [in the
+      source, rather than ``filename.*``], but tell the converter to
+      change references to the files anticipating that the files will
+      be converted too.
+
+      For example::
+
+        .. _Another Document: another.txt
+
+        rst2html.py --convert-links "another.txt bar.txt" foo.txt
+
+      That is, name the files for which extensions should be converted.
+
+      Note that I want to refer to original files in the original text
+      (another.txt rather than another.txt) because I want the
+      unconverted text to stand on its own.
+
+      Note that in most cases, people will be able to use globs::
+
+        rst2html.py --convert-link-extensions-for "`echo *.txt`" foo.txt
+
+      It might be nice to be able to use multiple arguments, as in::
+
+        rst2html.py --convert-link-extensions-for *.txt -- foo.txt
+
+      ::
+
+      > What is to be done for output formats
+      > that don't have hyperlinks?
+
+      Don't convert the links.
+
+      ::
+
+      > Handle documents only, or objects
+      > (images, etc.) also?
+
+      No, documents only, but there really is no need for gueswork.
+      Just get the file names as command-line arguments.  EIBTI
+      [explicit is better than implicit].
+
 * Implement the header row separator modification to table.el.  (Wrote
   to Takaaki Ota & the table.el mailing list on 2001-08-12, suggesting
   support for "=====" header rows.  On 2001-08-17 he replied, saying
-- 
2.11.4.GIT