Please find, for review, the debconf templates and packages descriptions for the auctex source package.
This review will last from Friday, November 02, 2007 to Monday, November 12, 2007.
Please send reviews as unified diffs (diff -u) against the original
files. Comments about your proposed changes will be appreciated.
Your review should be sent as an answer to this mail.
When appropriate, I will send intermediate requests for review, with
"[RFRn]" (n>=2) as a subject tag.
When we will reach a consensus, I send a "Last Chance For
Comments" mail with "[LCFC]" as a subject tag.
Finally, the reviewed templates will be sent to the package maintainer
as a bug report, and a mail will be sent to this list with "[BTS]" as
a subject tag.
Rationale:
--- ../auctex.old/debian/auctex/templates 2007-10-25 22:42:56.181222127 +0200
+++ debian/auctex/templates 2007-10-26 07:38:31.647423214 +0200
@@ -2,33 +2,36 @@
Type: select
__Choices: Background, Foreground, None
Default: Background
+#flag:comment:3
+# Translators: do NOT translate ${LOGFILE}
Just warn translators
_Description: (La)TeX macros parsing mode:
To greatly improve AUCTeX performances, every TeX macro package and LaTeX
- style file currently installed at your site will be parsed.
+ style file currently installed on this site will be parsed.
Unpersonnalization.
We could even drop the Emacs jargon of "site".
.
This may take a lot of time, so it should be probably done in the
- background; however you may also choose to have it done in the foreground,
- or to skip the parsing at all instead. If you choose Background, you will
- find a detailed log of the process in the file: ${LOGFILE}.
+ background. You may also choose to have it done in the foreground,
+ or to skip that step. If you choose 'Background', you will
+ find a detailed log of the process in ${LOGFILE}.
Split in short sentences and make them simpler
.
- A weekly cron job will also take care of updating the data collected now,
- so usually you won't need to worry about them whenever you install new
+ A weekly cron job will also take care of updating this data,
+ and therefore no specific action is required whenever you install new
(La)TeX packages or remove old ones.
slightly simplify the sentence
.
- Anyway, you can update them by hand running update-auctex-elisp.
+ This update can be run manually at any moment by running
+ 'update-auctex-elisp'.
Template: auctex/doautofg
Type: select
__Choices: Console, File
Default: File
+#flag:comment:3
+# Translators: do NOT translate ${LOGFILE}
_Description: Parsing output destination:
You chose to parse TeX macro packages and LaTeX style files in foreground.
- This is OK, but normally it will also generate quite a lot of output.
+ This operation generates a lot of information. Please choose where
+ this information should be sent:
Avoid spoken language ("This is OK")
.
- By default -- i.e., answering File to this question -- further output from
- the parsing process will go to a file named: ${LOGFILE}.
- .
- If you answer Console, you will see all of the (boring) output right on
- your terminal.
+ File: output goes to ${LOGFILE};
+ Console: output goes to the current console.
Simpler layout
# arch-tag: f0377964-4347-46dc-a310-3f371380b170-child
--- ../auctex.old/debian/control 2007-10-25 22:42:56.181222127 +0200
+++ debian/control 2007-10-27 09:41:33.092055376 +0200
@@ -4,7 +4,7 @@
Maintainer: Davide G. M. Salvetti <salve@debian.org>
Uploaders: OHURA Makoto <ohura@debian.org>
Standards-Version: 3.7.2
-Build-Depends-Indep: emacs22 | emacs21 | emacs-snapshot, eperl, gs-gpl | gs, po-debconf, texlive-latex-base, texinfo, texi2html (>=1.76-1)
+Homepage: http://www.gnu.org/software/auctex/
Package: auctex
Architecture: all
@@ -14,53 +14,47 @@
Conflicts: emacspeak (<= 17.0-1), preview-latex
Replaces: preview-latex
Provides: preview-latex
-Description: An integrated environment for editing TeX and friends documents
+Description: integrated environment for editing TeX and related documents
Avoid leading article
AUCTeX is a comprehensive customizable integrated environment for writing
input files for TeX/LaTeX/ConTeXt/Texinfo using Emacs.
.
- It lets you process your source files by running TeX and related tools (such
+ It allows processing source files by running TeX and related tools (such
Unpersonnalization
as output filters, post processors for generating indices and bibliographies,
- and viewers) from inside Emacs. AUCTeX lets you browse through the errors
- TeX reported, while it moves the cursor directly to the reported error, and
- displays some documentation for that particular error. This will even work
+ and viewers) from inside Emacs. AUCTeX allows browsing through the errors
+ reported by TeX, while it moves the cursor directly to the reported error, and
+ displays some documentation for that particular error. This will even work
Avoid double spaces
when the document is spread over several files.
.
- One component of AUCTeX that LaTeX users will find attractive is
- preview-latex, a combination of folding and in-source previewing that
- provides true "What You See Is What You Get" experience in your sourcebuffer,
- while letting you retain full control. preview-latex comes with its own
- manual.
Dropped and kept for the relevant package only
- .
- AUCTeX automatically indents your `LaTeX-source', not only as you write
- it---you can also let it indent and format an entire document. It has a
- special outline feature, which can greatly help you `getting an overview' of
+ AUCTeX automatically indents LaTeX 'source', not only as it is written
+ but also by reformatting an entire document. It has a
+ special outline feature, which can greatly help 'getting an overview' of
a document.
.
Apart from these special features, AUCTeX provides a large range of handy
- Emacs macros, which in several different ways can help you write your
+ Emacs macros, which in several different ways can help writing
documents fast and painlessly.
Unpersonnalize
.
All features of AUCTeX are documented using the GNU Emacs online
- documentation system. That is, documentation for any command is just a key
- click away!
+ documentation system.
Drop thesecond sentence which adds few information and is not neutral
enough to my taste..:)
.
- AUCTeX is written entirely in Emacs-Lisp, and hence you can easily add new
- features for your own needs. It has become recently a GNU project. AUCTeX
- is distributed under the `GNU General Public License Version 2'.
- .
- Currently XEmacs ships with its own AUCTeX, so this package should only
- be used with GNU/Emacs. (I.e., you don't need to install this package if
- your site uses only XEmacs.)
+ AUCTeX is written entirely in Emacs-Lisp, and may therefore be enhanced
+ with new features for specific needs. It is a GNU project.
No need to re-mention the license here
.
- Homepage: http://www.gnu.org/software/auctex/
Moved to "Homepage:" field
+ Currently XEmacs ships with its own AUCTeX version, so this package should only
+ be used with GNU/Emacs.
Splitted from previous paragraph
Package: preview-latex-style
Architecture: all
Depends: tex-common
Recommends: doc-base
Conflicts: preview-latex (<=0.7.3-2)
-Description: LaTeX style files for editor embedded preview of some environments
- These style files are allow previewing LaTeX environments such as math or
- figures in editors which support it.
- .
- Homepage: http://www.gnu.org/software/auctex/preview-latex.html
+Homepage: http://www.gnu.org/software/auctex/preview-latex.html
+Description: preview LaTeX output inside Emacsen
+ This package provides style files that enable previewing of equations
+ or figures in supported LaTeX environments.
+ .
+ Designed for LaTeX users,
+ preview-latex is a combination of folding and in-source previewing that
+ provides true "What You See Is What You Get" experience in the sourcebuffer,
+ while keeping full control. This utility comes with its own
+ manual.
Moved from the auctex binary package description ? It belongs to this
one, not the other one.
Use the common "This package provides" style...
--
Template: auctex/doauto
Type: select
__Choices: Background, Foreground, None
Default: Background
#flag:comment:3
# Translators: do NOT translate ${LOGFILE}
_Description: (La)TeX macros parsing mode:
To greatly improve AUCTeX performances, every TeX macro package and LaTeX
style file currently installed on this site will be parsed.
.
This may take a lot of time, so it should be probably done in the
background. You may also choose to have it done in the foreground,
or to skip that step. If you choose 'Background', you will
find a detailed log of the process in ${LOGFILE}.
.
A weekly cron job will also take care of updating this data,
and therefore no specific action is required whenever you install new
(La)TeX packages or remove old ones.
.
This update can be run manually at any moment by running
'update-auctex-elisp'.
Template: auctex/doautofg
Type: select
__Choices: Console, File
Default: File
#flag:comment:3
# Translators: do NOT translate ${LOGFILE}
_Description: Parsing output destination:
You chose to parse TeX macro packages and LaTeX style files in foreground.
This operation generates a lot of information. Please choose where
this information should be sent:
.
File: output goes to ${LOGFILE};
Console: output goes to the current console.
# arch-tag: f0377964-4347-46dc-a310-3f371380b170-child
--- auctex.old/debian/auctex/templates 2007-10-25 22:42:56.181222127 +0200
+++ auctex/debian/auctex/templates 2007-10-26 07:38:31.647423214 +0200
@@ -2,33 +2,36 @@
Type: select
__Choices: Background, Foreground, None
Default: Background
+#flag:comment:3
+# Translators: do NOT translate ${LOGFILE}
_Description: (La)TeX macros parsing mode:
To greatly improve AUCTeX performances, every TeX macro package and LaTeX
- style file currently installed at your site will be parsed.
+ style file currently installed on this site will be parsed.
.
This may take a lot of time, so it should be probably done in the
- background; however you may also choose to have it done in the foreground,
- or to skip the parsing at all instead. If you choose Background, you will
- find a detailed log of the process in the file: ${LOGFILE}.
+ background. You may also choose to have it done in the foreground,
+ or to skip that step. If you choose 'Background', you will
+ find a detailed log of the process in ${LOGFILE}.
.
- A weekly cron job will also take care of updating the data collected now,
- so usually you won't need to worry about them whenever you install new
+ A weekly cron job will also take care of updating this data,
+ and therefore no specific action is required whenever you install new
(La)TeX packages or remove old ones.
.
- Anyway, you can update them by hand running update-auctex-elisp.
+ This update can be run manually at any moment by running
+ 'update-auctex-elisp'.
Template: auctex/doautofg
Type: select
__Choices: Console, File
Default: File
+#flag:comment:3
+# Translators: do NOT translate ${LOGFILE}
_Description: Parsing output destination:
You chose to parse TeX macro packages and LaTeX style files in foreground.
- This is OK, but normally it will also generate quite a lot of output.
+ This operation generates a lot of information. Please choose where
+ this information should be sent:
.
- By default -- i.e., answering File to this question -- further output from
- the parsing process will go to a file named: ${LOGFILE}.
- .
- If you answer Console, you will see all of the (boring) output right on
- your terminal.
+ File: output goes to ${LOGFILE};
+ Console: output goes to the current console.
# arch-tag: f0377964-4347-46dc-a310-3f371380b170-child
--- auctex.old/debian/control 2007-10-25 22:42:56.181222127 +0200
+++ auctex/debian/control 2007-11-02 12:32:19.377041547 +0100
@@ -4,7 +4,7 @@
Maintainer: Davide G. M. Salvetti <salve@debian.org>
Uploaders: OHURA Makoto <ohura@debian.org>
Standards-Version: 3.7.2
-Build-Depends-Indep: emacs22 | emacs21 | emacs-snapshot, eperl, gs-gpl | gs, po-debconf, texlive-latex-base, texinfo, texi2html (>=1.76-1)
+Homepage: http://www.gnu.org/software/auctex/
Package: auctex
Architecture: all
@@ -14,53 +14,47 @@
Conflicts: emacspeak (<= 17.0-1), preview-latex
Replaces: preview-latex
Provides: preview-latex
-Description: An integrated environment for editing TeX and friends documents
+Description: integrated environment for editing TeX and related documents
AUCTeX is a comprehensive customizable integrated environment for writing
input files for TeX/LaTeX/ConTeXt/Texinfo using Emacs.
.
- It lets you process your source files by running TeX and related tools (such
+ It allows processing source files by running TeX and related tools (such
as output filters, post processors for generating indices and bibliographies,
- and viewers) from inside Emacs. AUCTeX lets you browse through the errors
- TeX reported, while it moves the cursor directly to the reported error, and
- displays some documentation for that particular error. This will even work
+ and viewers) from inside Emacs. AUCTeX allows browsing through the errors
+ reported by TeX, while it moves the cursor directly to the reported error, and
+ displays some documentation for that particular error. This will even work
when the document is spread over several files.
.
- One component of AUCTeX that LaTeX users will find attractive is
- preview-latex, a combination of folding and in-source previewing that
- provides true "What You See Is What You Get" experience in your sourcebuffer,
- while letting you retain full control. preview-latex comes with its own
- manual.
- .
- AUCTeX automatically indents your `LaTeX-source', not only as you write
- it---you can also let it indent and format an entire document. It has a
- special outline feature, which can greatly help you `getting an overview' of
+ AUCTeX automatically indents LaTeX 'source', not only as it is written
+ but also by reformatting an entire document. It has a
+ special outline feature, which can greatly help 'getting an overview' of
a document.
.
Apart from these special features, AUCTeX provides a large range of handy
- Emacs macros, which in several different ways can help you write your
+ Emacs macros, which in several different ways can help writing
documents fast and painlessly.
.
All features of AUCTeX are documented using the GNU Emacs online
- documentation system. That is, documentation for any command is just a key
- click away!
+ documentation system.
.
- AUCTeX is written entirely in Emacs-Lisp, and hence you can easily add new
- features for your own needs. It has become recently a GNU project. AUCTeX
- is distributed under the `GNU General Public License Version 2'.
- .
- Currently XEmacs ships with its own AUCTeX, so this package should only
- be used with GNU/Emacs. (I.e., you don't need to install this package if
- your site uses only XEmacs.)
+ AUCTeX is written entirely in Emacs-Lisp, and may therefore be enhanced
+ with new features for specific needs. It is a GNU project.
.
- Homepage: http://www.gnu.org/software/auctex/
+ Currently XEmacs ships with its own AUCTeX version, so this package should only
+ be used with GNU/Emacs.
Package: preview-latex-style
Architecture: all
Depends: tex-common
Recommends: doc-base
Conflicts: preview-latex (<=0.7.3-2)
-Description: LaTeX style files for editor embedded preview of some environments
- These style files are allow previewing LaTeX environments such as math or
- figures in editors which support it.
- .
- Homepage: http://www.gnu.org/software/auctex/preview-latex.html
+Homepage: http://www.gnu.org/software/auctex/preview-latex.html
+Description: preview LaTeX output inside Emacsen
+ This package provides style files that enable previewing of equations
+ or figures in supported LaTeX environments.
+ .
+ Designed for LaTeX users,
+ preview-latex is a combination of folding and in-source previewing that
+ provides true "What You See Is What You Get" experience in the sourcebuffer,
+ while keeping full control. This utility comes with its own
+ manual.
Source: auctex Priority: optional Section: tex Maintainer: Davide G. M. Salvetti <salve@debian.org> Uploaders: OHURA Makoto <ohura@debian.org> Standards-Version: 3.7.2 Homepage: http://www.gnu.org/software/auctex/ Package: auctex Architecture: all Depends: debconf | debconf-2.0, emacs22 | emacs21 | emacs-snapshot, make, preview-latex-style Recommends: doc-base, gs-gpl | gs, texlive-latex-recommended, xpdf-reader | pdf-viewer Suggests: catdvi, dvipng, lacheck Conflicts: emacspeak (<= 17.0-1), preview-latex Replaces: preview-latex Provides: preview-latex Description: integrated environment for editing TeX and related documents AUCTeX is a comprehensive customizable integrated environment for writing input files for TeX/LaTeX/ConTeXt/Texinfo using Emacs. . It allows processing source files by running TeX and related tools (such as output filters, post processors for generating indices and bibliographies, and viewers) from inside Emacs. AUCTeX allows browsing through the errors reported by TeX, while it moves the cursor directly to the reported error, and displays some documentation for that particular error. This will even work when the document is spread over several files. . AUCTeX automatically indents LaTeX 'source', not only as it is written but also by reformatting an entire document. It has a special outline feature, which can greatly help 'getting an overview' of a document. . Apart from these special features, AUCTeX provides a large range of handy Emacs macros, which in several different ways can help writing documents fast and painlessly. . All features of AUCTeX are documented using the GNU Emacs online documentation system. . AUCTeX is written entirely in Emacs-Lisp, and may therefore be enhanced with new features for specific needs. It is a GNU project. . Currently XEmacs ships with its own AUCTeX version, so this package should only be used with GNU/Emacs. Package: preview-latex-style Architecture: all Depends: tex-common Recommends: doc-base Conflicts: preview-latex (<=0.7.3-2) Homepage: http://www.gnu.org/software/auctex/preview-latex.html Description: preview LaTeX output inside Emacsen This package provides style files that enable previewing of equations or figures in supported LaTeX environments. . Designed for LaTeX users, preview-latex is a combination of folding and in-source previewing that provides true "What You See Is What You Get" experience in the sourcebuffer, while keeping full control. This utility comes with its own manual.
Attachment:
signature.asc
Description: Digital signature