[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

[RFR2] templates://auctex/{auctex/templates}



Given the numerous discussions around that proofreading work (thanks,
Frank, for such involvment in this work: it's always interesting and
motivating to have such exchanges with maintainers), I think it is
needed to summarize what I have ended up to as of now.

I'm not entirely sure that I included all suggestions and proposed
modifications, so feel free to comment.


--- auctex.old/debian/auctex/templates	2007-10-25 22:42:56.181222127 +0200
+++ auctex/debian/auctex/templates	2007-11-03 12:42:31.205028477 +0100
@@ -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.
+ To improve the performance of AUCTeX, every currently installed TeX
+ macro package and LaTeX style file 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}.
+ This may take a lot of time, so it should probably be 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 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 the cached data,
+ so that 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-04 08:38:30.193193124 +0100
@@ -5,6 +5,7 @@
 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 +15,35 @@
 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 document editing environment for TeX etc.
  AUCTeX is a comprehensive customizable integrated environment for writing
- input files for TeX/LaTeX/ConTeXt/Texinfo using Emacs.
+ input files for TeX/LaTeX/ConTeXt/Texinfo using GNU Emacs. Currently XEmacs
+ ships with its own AUCTeX version.
  .
- It lets you process your source files by running TeX and related tools (such
+ It supports 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
- 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
- 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!
- .
- 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.)
- .
- Homepage: http://www.gnu.org/software/auctex/
+ AUCTeX can automatically indent LaTeX 'source', either line by line or
+ for an entire document, and has a special outline feature which can
+ greatly assist in getting an overview of a document.
+ .
+ AUCTeX is written entirely in Emacs Lisp, and may therefore be enhanced
+ with new features for specific needs. It comes with a large range of
+ handy Emacs macros. It is a GNU project, and documentation for all its
+ features is accessible via the Emacs info browser.
 
 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: style files to support LaTeX output previewing in Emacs
+ This package provides style files that enable previewing of equations,
+ figures or other LaTeX environments. It combines folding with in-source
+ previewing to give a true WYSIWYG experience in the source buffer
+ without sacrificing control. This utility comes with its own manual.
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 improve the performance of AUCTeX, every currently installed TeX
 macro package and LaTeX style file will be parsed.
 .
 This may take a lot of time, so it should probably be 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 the cached data,
 so that 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
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
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
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 document editing environment for TeX etc.
 AUCTeX is a comprehensive customizable integrated environment for writing
 input files for TeX/LaTeX/ConTeXt/Texinfo using GNU Emacs. Currently XEmacs
 ships with its own AUCTeX version.
 .
 It supports 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 can automatically indent LaTeX 'source', either line by line or
 for an entire document, and has a special outline feature which can
 greatly assist in getting an overview of a document.
 .
 AUCTeX is written entirely in Emacs Lisp, and may therefore be enhanced
 with new features for specific needs. It comes with a large range of
 handy Emacs macros. It is a GNU project, and documentation for all its
 features is accessible via the Emacs info browser.

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: style files to support LaTeX output previewing in Emacs
 This package provides style files that enable previewing of equations,
 figures or other LaTeX environments. It combines folding with in-source
 previewing to give a true WYSIWYG experience in the source buffer
 without sacrificing control. This utility comes with its own manual.

Attachment: signature.asc
Description: Digital signature


Reply to: