Commit 3013ced8 authored by Juanma Barranquero's avatar Juanma Barranquero
Browse files

(iso-translate-conventions): Doc fix.

(iso-aggressive-german-trans-tab, iso-conservative-german-trans-tab,
iso-tex2iso-trans-tab, iso-gtex2iso-trans-tab): Reflow docstring.
(iso-spanish, iso-german, iso-iso2tex, iso-tex2iso, iso-gtex2iso, iso-iso2gtex,
iso-iso2duden, iso-iso2sgml, iso-sgml2iso): Rewrite in active voice.
parent 34065e5e
......@@ -65,7 +65,7 @@
"Spanish translation table.")
(defun iso-translate-conventions (from to trans-tab)
"Use the translation table TRANS-TAB to translate the current buffer."
"Translate between FROM and TO using the translation table TRANS-TAB."
(save-excursion
(save-restriction
(narrow-to-region from to)
......@@ -84,8 +84,8 @@
;;;###autoload
(defun iso-spanish (from to &optional buffer)
"Translate net conventions for Spanish to ISO 8859-1.
The region between FROM and TO is translated using
the table `iso-spanish-trans-tab'.
Translate the region between FROM and TO using the table
`iso-spanish-trans-tab'.
Optional arg BUFFER is ignored (for use in `format-alist')."
(interactive "*r")
(iso-translate-conventions from to iso-spanish-trans-tab))
......@@ -102,8 +102,8 @@ Optional arg BUFFER is ignored (for use in `format-alist')."
("\\\\3" "ß")
)
"German translation table.
This table uses an aggressive translation approach and may erroneously
translate too much.")
This table uses an aggressive translation approach
and may erroneously translate too much.")
(defvar iso-conservative-german-trans-tab
'(
......@@ -117,8 +117,8 @@ translate too much.")
("\\([-a-zA-Z\"`]\\)\\\\3" "\\1ß")
)
"German translation table.
This table uses a conservative translation approach and may translate too
little.")
This table uses a conservative translation approach
and may translate too little.")
(defvar iso-german-trans-tab iso-aggressive-german-trans-tab
"Currently active translation table for German.")
......@@ -126,8 +126,8 @@ little.")
;;;###autoload
(defun iso-german (from to &optional buffer)
"Translate net conventions for German to ISO 8859-1.
The region between FROM and TO is translated using
the table `iso-german-trans-tab'.
Translate the region FROM and TO using the table
`iso-german-trans-tab'.
Optional arg BUFFER is ignored (for use in `format-alist')."
(interactive "*r")
(iso-translate-conventions from to iso-german-trans-tab))
......@@ -199,8 +199,8 @@ Optional arg BUFFER is ignored (for use in `format-alist')."
;;;###autoload
(defun iso-iso2tex (from to &optional buffer)
"Translate ISO 8859-1 characters to TeX sequences.
The region between FROM and TO is translated using
the table `iso-iso2tex-trans-tab'.
Translate the region between FROM and TO using the table
`iso-iso2tex-trans-tab'.
Optional arg BUFFER is ignored (for use in `format-alist')."
(interactive "*r")
(iso-translate-conventions from to iso-iso2tex-trans-tab))
......@@ -386,14 +386,14 @@ Optional arg BUFFER is ignored (for use in `format-alist')."
("!`" "¡")
)
"Translation table for translating TeX sequences to ISO 8859-1 characters.
This table is not exhaustive (and due to TeX's power can never be). It only
contains commonly used sequences.")
This table is not exhaustive (and due to TeX's power can never be).
It only contains commonly used sequences.")
;;;###autoload
(defun iso-tex2iso (from to &optional buffer)
"Translate TeX sequences to ISO 8859-1 characters.
The region between FROM and TO is translated using
the table `iso-tex2iso-trans-tab'.
Translate the region between FROM and TO using the table
`iso-tex2iso-trans-tab'.
Optional arg BUFFER is ignored (for use in `format-alist')."
(interactive "*r")
(iso-translate-conventions from to iso-tex2iso-trans-tab))
......@@ -581,8 +581,8 @@ Optional arg BUFFER is ignored (for use in `format-alist')."
("\\\\3" "ß")
)
"Translation table for translating German TeX sequences to ISO 8859-1.
This table is not exhaustive (and due to TeX's power can never be). It only
contains commonly used sequences.")
This table is not exhaustive (and due to TeX's power can never be).
It only contains commonly used sequences.")
(defvar iso-iso2gtex-trans-tab
'(
......@@ -651,8 +651,8 @@ contains commonly used sequences.")
;;;###autoload
(defun iso-gtex2iso (from to &optional buffer)
"Translate German TeX sequences to ISO 8859-1 characters.
The region between FROM and TO is translated using
the table `iso-gtex2iso-trans-tab'.
Translate the region between FROM and TO using the table
`iso-gtex2iso-trans-tab'.
Optional arg BUFFER is ignored (for use in `format-alist')."
(interactive "*r")
(iso-translate-conventions from to iso-gtex2iso-trans-tab))
......@@ -660,8 +660,8 @@ Optional arg BUFFER is ignored (for use in `format-alist')."
;;;###autoload
(defun iso-iso2gtex (from to &optional buffer)
"Translate ISO 8859-1 characters to German TeX sequences.
The region between FROM and TO is translated using
the table `iso-iso2gtex-trans-tab'.
Translate the region between FROM and TO using the table
`iso-iso2gtex-trans-tab'.
Optional arg BUFFER is ignored (for use in `format-alist')."
(interactive "*r")
(iso-translate-conventions from to iso-iso2gtex-trans-tab))
......@@ -679,8 +679,8 @@ Optional arg BUFFER is ignored (for use in `format-alist')."
;;;###autoload
(defun iso-iso2duden (from to &optional buffer)
"Translate ISO 8859-1 characters to Duden sequences.
The region between FROM and TO is translated using
the table `iso-iso2duden-trans-tab'.
Translate the region between FROM and TO using the table
`iso-iso2duden-trans-tab'.
Optional arg BUFFER is ignored (for use in `format-alist')."
(interactive "*r")
(iso-translate-conventions from to iso-iso2duden-trans-tab))
......@@ -817,7 +817,7 @@ Optional arg BUFFER is ignored (for use in `format-alist')."
;;;###autoload
(defun iso-iso2sgml (from to &optional buffer)
"Translate ISO 8859-1 characters in the region to SGML entities.
The entities used are from \"ISO 8879:1986//ENTITIES Added Latin 1//EN\".
Use entities from \"ISO 8879:1986//ENTITIES Added Latin 1//EN\".
Optional arg BUFFER is ignored (for use in `format-alist')."
(interactive "*r")
(iso-translate-conventions from to iso-iso2sgml-trans-tab))
......@@ -825,7 +825,7 @@ Optional arg BUFFER is ignored (for use in `format-alist')."
;;;###autoload
(defun iso-sgml2iso (from to &optional buffer)
"Translate SGML entities in the region to ISO 8859-1 characters.
The entities used are from \"ISO 8879:1986//ENTITIES Added Latin 1//EN\".
Use entities from \"ISO 8879:1986//ENTITIES Added Latin 1//EN\".
Optional arg BUFFER is ignored (for use in `format-alist')."
(interactive "*r")
(iso-translate-conventions from to iso-sgml2iso-trans-tab))
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment