latex2e writer: backwards compatible implementation of failsave custom roles

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

2 files changed, 30 insertions, 9 deletions

diff --git a/test/functional/input/data/custom_roles_latex.txt b/test/functional/input/data/custom_roles_latex.txt
new file mode 100644
index 000000000..cc423fcf4
--- /dev/null
+++ b/test/functional/input/data/custom_roles_latex.txt
@@ -0,0 +1,28 @@
+Custom Roles in LaTeX
+---------------------
+
+* Role names and class arguments are are converted to conform to the regular
+  expression ``[a-z][-a-z0-9]*`` (all non-conforming characters are replaced
+  by a hyphen, all letters are downcased).
+
+  Class arguments may contain numbers and hyphens, which need special
+  treatment in LaTeX command names.
+
+  .. role:: custom4
+     :class: large custom4 small_caps custom.role custom\role
+
+  :custom4:`Interpreted Text`
+
+
+* With LaTeX, roles can be styled within the document using the `raw`
+  directive.
+
+  .. raw:: latex
+
+    \newcommand{\docutilsrolelarge}[1]{{\large #1}}
+    \makeatletter
+    \@namedef{docutilsrolesmall-caps}{\textsc}
+    \@namedef{docutilsrolecustom4}{\textbf}
+    \makeatother
+
+  :custom4:`Interpreted Text` in large, bold, small-caps.
diff --git a/test/functional/input/data/latex2e.txt b/test/functional/input/data/option_lists.txt
index 223831c16..285143244 100644
--- a/test/functional/input/data/latex2e.txt
+++ b/test/functional/input/data/option_lists.txt
@@ -1,14 +1,7 @@
-Some Tests for the LaTeX2e Writer
-=================================
-
-These tests have been written to exercise some unusual combinations of
-syntax elements which may cause trouble for the LaTeX writer but do
-not need to be tested with other writers (e.g. the HTML writer).
-
-This file is user by the standalone_rst_latex test.
+.. This file is used by the standalone_rst_latex test.
 
 Option lists
-============
+------------
 
 The LaTeX-2e description environment is used for definition lists. 
 The definition is continued on the same line as the term, this should