Re: [RFR] templates://auctex/{auctex/templates}
Frank Küster wrote:
> Justin B Rye <jbr@edlug.org.uk> wrote:
>>> AUCTeX is a comprehensive customizable integrated environment for writing
>>> input files for TeX/LaTeX/ConTeXt/Texinfo using Emacs.
>>
>> GNU Emacs only (and looking at the docs it seems to be TeX/LaTeX and
>> probably not much else).
>
> There's a ConTeXt mode now, too. And Doc mode, which isn't really LaTeX.
My patch didn't alter the "TeX/LaTeX/ConTeXt/Texinfo" anyway.
>> Description: style files to support LaTeX output previewing in Emacs
>
> That's okay.
>
>> Its dependencies imply this package is useful even with no version
>> of emacs installed, but I suspect that again it's specific to GNU
>> Emacs.
>
> That's not true, it simply tweaks TeX so that it generates a document
> with tiny one-image-pages from your formulas, section headings, figures
> etc., and those images can be displayed anywhere (e.g. in a html
> document created from the same source).
I don't see how these can both be right. It (a) exists to allow
previewing in Emacs but (b) doesn't need to suggest any emacsen?
>>> + This package provides style files that enable previewing of equations
>>> + or figures in supported LaTeX environments.
>>
>> It would be really helpful to know whether in fact there are any.
> [...]
>> This package provides style files that enable previewing of equations
>> or figures in supported 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.
>
> s/equations or figures in supported LaTeX environments/equations,
> figures or other LaTeX environments/.
Ah! So "environments" means different types of output? Thanks for
the fix. Of course, this means the word is being used in a TeXnical
sense here and more normally in the auctex package description (an
"integrated environment for writing" TeX). That should be okay,
shouldn't it?
Meanwhile I've just noticed there's a chunk of repeated text in my
patched preview-latex-style package description. I'll attach a
revised version with the "or other LaTeX environments" correction.
--
JBR
Ankh kak! (Ancient Egyptian blessing)
--- ../auctex.old/debian/templates 2007-10-29 09:00:58.000000000 +0000
+++ debian/templates 2007-11-02 21:58:18.000000000 +0000
@@ -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 performance, 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
- (La)TeX packages or remove old ones.
+ A weekly cron job will also take care of updating the cached data,
+ so that no specific action is required when (La)TeX packages are
+ added or removed.
.
- 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-29 09:00:58.000000000 +0000
+++ debian/control 2007-11-03 22:02:05.000000000 +0000
@@ -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 performance, 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 when (La)TeX packages are
added or removed.
.
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.
Reply to: