update aastex documentation; remove Mike Ressler's address

git-svn-id: svn://svn.lyx.org/lyx/lyx-devel/trunk@9604 a592a061-630c-0410-9148-cb99ea01b6c8

lib/doc/ChangeLog

@@ -1,3 +1,11 @@
+2005-02-08  Jean-Marc Lasgouttes  <lasgouttes@lyx.org>
+
+	* Extended.lyx: update aastex description (from Mike Ressler)
+
+	* FAQ.lyx:
+	* *_FAQ.lyx:
+	* plExtended.lyx: remove Mike Ressler's e-mail address
+
 2005-02-07  Jean-Marc Lasgouttes  <lasgouttes@lyx.org>
 
 	* TOC.lyx: regenerate with doc_toc.py

lib/doc/Extended.lyx

@@ -5087,14 +5087,17 @@ AASTeX is a set of macros produced by the American Astronomical Society
  publish: the Astrophysical Journal (including the Letters and Supplement),
  the Astronomical Journal, and the Publications of the Astronomical Society
  of the Pacific.
- LyX requires version 5.0 (or higher) of these macros.
+ LyX has proven to be an excellent tool for generating these documents,
+ especially given its equation, citation, and figure handling capabilities.
+ LyX requires version 5.0 (or higher) of these macros; preferably 5.2, which
+ is the version described here, or higher.
  Versions prior to 5.0 are intended for use with LaTeX2.09 and are fundamentally
  incompatible with LyX.
- The AASTeX package may be downloaded from the AAS's ftp site
+ The AASTeX package may be downloaded from the AASTeX Web site
 \layout Standard
 \added_space_top medskip \added_space_bottom medskip \align center 
 
-\begin_inset LatexCommand \url{ftp://ftp.aas.org/pubs}
+\begin_inset LatexCommand \url{http://www.journals.uchicago.edu/AAS/AASTeX}
 
 \end_inset 
 
@@ -5156,7 +5159,7 @@ altaffiltext
  marked as such.
  Such commands are referred to as ERT, or Evil Red Text.
  I tried to minimize the amount of ERT needed in an AASTeX document, but
- there is still more required than any of us would like.
+ there is still a bit more required than any of us would like.
 \layout Subsection
 
 Finishing Your Paper
@@ -5190,7 +5193,7 @@ xport\SpecialChar \menuseparator
 \bar under 
 L
 \bar default 
-ateX
+aTeX
 \family default 
 ).
  
@@ -5260,42 +5263,6 @@ User specified LaTeX commands
 .tex
 \family default 
  file).
-\layout Enumerate
-
-search for any 
-\family typewriter 
-
-\backslash 
-figcaption
-\family default 
- commands and replace 
-\begin_inset Quotes eld
-\end_inset 
-
-
-\family typewriter 
-FileName
-\family default 
-
-\begin_inset Quotes erd
-\end_inset 
-
- with the correct, real file name.
-\layout Enumerate
-
-alter any 
-\family typewriter 
-
-\backslash 
-cite
-\family default 
- commands, if necessary (see section\SpecialChar ~
-
-\begin_inset LatexCommand \ref{cite}
-
-\end_inset 
-
- below).
 \end_deeper 
 \layout Enumerate
 
@@ -5410,110 +5377,121 @@ paragraph
  (2.7),
 \family typewriter 
  
+\backslash 
+facility
+\family default 
+ (2.10), 
+\family typewriter 
+
 \backslash 
 begin{displaymath}
 \family default 
- (2.11), 
+ (2.12), 
 \family typewriter 
 
 \backslash 
 begin{equation}
 \family default 
- (2.11), 
+ (2.12), 
 \family typewriter 
 
 \backslash 
 begin{eqnarray}
 \family default 
- (2.11), 
+ (2.12), 
 \family typewriter 
 
 \backslash 
 begin{mathletters}
 \family default 
- (2.11), 
+ (2.12), 
 \family typewriter 
 
 \backslash 
 begin{thebibliography}
 \family default 
- (2.12.1), 
+ (2.13.1), 
 \family typewriter 
 
 \backslash 
 bibitem
 \family default 
- (2.12.2), 
+ (2.13.2), all the cite commands and their variations (2.13.2), the generic
+ graphicx figure commands (2.14.1),
 \family typewriter 
  
 \backslash 
 begin{table}
 \family default 
- (2.14.4), 
+ (2.15.4), 
 \family typewriter 
 
 \backslash 
 begin{tabular}
 \family default 
- (2.14.4), 
+ (2.15.4), 
 \family typewriter 
 
 \backslash 
 caption
 \family default 
- (2.14.4), 
+ (2.15.4), 
 \family typewriter 
 
 \backslash 
 label
 \family default 
- (2.14.4, amongst other places), 
+ (2.15.4, amongst other places), 
 \family typewriter 
 
 \backslash 
 tablerefs
 \family default 
- (2.14.5), 
+ (2.15.5), 
 \family typewriter 
 
 \backslash 
 tablecomments
 \family default 
- (2.14.5), 
+ (2.15.5), 
 \family typewriter 
 
 \backslash 
 url
 \family default 
- (2.15.4), 
+ (2.17.4), 
 \family typewriter 
 
 \backslash 
 end{document}
 \family default 
- (2.16).
+ (2.18).
 \layout Standard
 
 The following style options also work correctly: 
 \family typewriter 
+longabstract
+\family default 
+ (2.4), 
+\family typewriter 
 preprint
 \family default 
-, 
+ (3.2.1), 
 \family typewriter 
 preprint2
 \family default 
-, 
+ (3.2.2), 
 \family typewriter 
 eqsecnum
 \family default 
-, 
+ (3.3), 
 \family typewriter 
 flushrt
 \family default 
- (3, 3.1, 3.2).
+ (3.4).
- Simply put them in 
+ Simply put them in the 
 \family sans 
-Extra Options
+Options
 \family default 
  box in 
 \family sans 
@@ -5683,7 +5661,7 @@ acknowledgements
 \backslash 
 appendix
 \family default 
- (2.10) -- will have extra {} after it.
+ (2.11) -- will have extra {} after it.
  This should not cause an error.
 \layout Itemize
 
@@ -5693,8 +5671,59 @@ appendix
 \backslash 
 figcaption
 \family default 
- (2.13.2) -- you will have to edit the optional argument by hand in the final
+ (2.14.2) -- you can insert an optional filename argument by placing the cursor
- LaTeX file.
+ at the beginning of the text and selecting 
+\family sans 
+Insert\SpecialChar \menuseparator
+Short Title
+\family default 
+.
+ 
+\begin_inset Quotes eld
+\end_inset 
+
+Short Title
+\begin_inset Quotes erd
+\end_inset 
+
+ inserts an optional argument of the type needed by 
+\family typewriter 
+
+\backslash 
+figcaption
+\family default 
+.
+ Hopefully it will be renamed someday.
+\layout Itemize
+
+
+\family typewriter 
+
+\backslash 
+objectname
+\family default 
+ (2.17.1) -- same as 
+\family typewriter 
+
+\backslash 
+figcaption
+\family default 
+ for the catalog ID optional parameter
+\layout Itemize
+
+
+\family typewriter 
+
+\backslash 
+dataset
+\family default 
+ (2.17.1) -- same as 
+\family typewriter 
+
+\backslash 
+figcaption
+\family default 
+ for the catalog ID optional parameter
 \layout Subsubsection
 
 Things not implemented, use ERT
@@ -5731,61 +5760,49 @@ altaffiltext
 \backslash 
 eqnum
 \family default 
- (2.11), 
+ (2.12), 
 \family typewriter 
 
 \backslash 
 setcounter{equation}
 \family default 
- (2.11), 
+ (2.12), Journal name abbreviations (2.13.4), 
-\family typewriter 
-
-\backslash 
-citet
-\family default 
- (2.12), 
-\family typewriter 
-
-\backslash 
-citep
-\family default 
- (2.12), Journal name abbreviations (2.12.4), 
 \family typewriter 
 
 \backslash 
 figurenum
 \family default 
- (2.13.1), 
+ (2.14.1), 
 \family typewriter 
 
 \backslash 
 epsscale
 \family default 
- (2.13.1), 
+ (2.14.1), 
 \family typewriter 
 
 \backslash 
 plotone
 \family default 
- (2.13.1), 
+ (2.14.1), 
 \family typewriter 
 
 \backslash 
 plottwo
 \family default 
- (2.13.1), 
+ (2.14.1), 
 \family typewriter 
 
 \backslash 
 tablenum
 \family default 
- (2.14.4), 
+ (2.15.4), 
 \family typewriter 
 
 \backslash 
 tableline
 \family default 
- (2.14.4, insert it as the first element in the lefthand cell after where
+ (2.15.4, insert it as the first element in the lefthand cell after where
  you want it.
  Don't use any of LyX's rules in the table), 
 \family typewriter 
@@ -5793,19 +5810,31 @@ tableline
 \backslash 
 tablenotemark
 \family default 
- (2.14.5), 
+ (2.15.5), 
 \family typewriter 
 
 \backslash 
 tablenotetext
 \family default 
- (2.14.5), most everything in Misc (2.15, except 
+ (2.15.5), much of Misc (2.17, except 
+\family typewriter 
+
+\backslash 
+objectname
+\family default 
+,
+\family typewriter 
+ 
+\backslash 
+dataset
+\family default 
+,
 \family typewriter 
  
 \backslash 
 url
 \family default 
- and 
+, and 
 \family typewriter 
 
 \backslash 
@@ -5856,8 +5885,8 @@ Things that cannot be implemented
 
 \SpecialChar \ldots{}
  at least in any meaningful sort of way, so I suggest ignoring them.
- They are the references environment (2.12.3), and the deluxetable environment
+ They are the references environment (2.13.3), and the deluxetable environment
- (2.14).
+ (2.15).
  If you really, really need to use deluxetable, I suggest editing it in
  a separate file with a text editor, then using 
 \family sans 
@@ -5999,8 +6028,8 @@ References
 
 \layout Standard
 
-A few things: 1) I have noticed some funny spacing in the reference entries
+A couple of things: 1) I have noticed some funny spacing in the reference
- in the text.
+ entries in the text.
  When you enter the bibliography item data, make sure their is 
 \emph on 
 no
@@ -6020,77 +6049,7 @@ type
 Ressler (1992)
 \family default 
 .
- 2) I am really unhappy that I can't make 
+ 2) Entering the references at all is not obvious.
-\family typewriter 
-
-\backslash 
-citet
-\family default 
- and 
-\family typewriter 
-
-\backslash 
-citep
-\family default 
- more automatic, but that would require changes to the LyX source code.
- For now you can do one of two things: a) enter all your citations using
- the built-in 
-\family sans 
-Insert\SpecialChar \menuseparator
-Citation Reference
-\family default 
- mechanism; at least you can take advantage of the automatic insertions.
- Then edit the exported LaTeX file by hand changing the 
-\family typewriter 
-
-\backslash 
-cite
-\family default 
- entries to the appropriate 
-\family typewriter 
-
-\backslash 
-citet
-\family default 
- or 
-\family typewriter 
-
-\backslash 
-citep
-\family default 
- commands before you submit it (
-\family typewriter 
-
-\backslash 
-cite
-\family default 
- is currently equivalent to 
-\family typewriter 
-
-\backslash 
-citet
-\family default 
-, so you wouldn't necessarily have to change those).
- Or b) you can simply enter all your citations as ERT using the same key
- for the argument that you used in the bibliography dialog, 
-\emph on 
-e.g.
-
-\emph default 
- 
-\family typewriter 
-
-\backslash 
-citet{key}
-\family default 
-.
- Neither choice is pleasant, but until LyX's citation mechanism understands
- 
-\family typewriter 
-natbib
-\family default 
-, we'll have to put up with it.
- 3) Entering the references at all is not obvious.
  The easiest thing is to start typing your first reference at the end of
  the document, then mark it as type 
 \family sans 
@@ -6106,43 +6065,41 @@ References
 Including EPS files
 \layout Standard
 
-With all due respect to Chris Biemesderfer and the others who have helped
+Even though AASTeX provides its own figure commands (
- to write the AASTeX package, the figure handling mechanism smells really
+\family typewriter 
- foul.
+
+\backslash 
+plotone
+\family default 
+, for example), I much prefer LaTeX's standard figure commands (with the
+ default graphicx).
  You can insert the 
 \family typewriter 
 
 \backslash 
 plotone
 \family default 
-, etc.
+, etc.\SpecialChar ~
-\begin_inset ERT
+commands as ERT into a Figure Float box if you desire, but I never
-status Inlined
+ have much luck getting the layout right.
-
+ With the standard graphics, LyX will insert a 
-\layout Standard
-
-\backslash 
- 
-\end_inset 
-
-commands as ERT into a Figure Float box, but I never have much luck getting
- the layout right.
- My advice would be to avoid all EPS inclusions in the manuscript you submit
- to the journal, but then use the standard LyX EPS file inclusion mechanism
- when you want to make your nicer looking preprints.
- LyX will insert a 
 \family typewriter 
 
 \backslash 
-usepackage{graphics}
+usepackage{graphicx}
 \family default 
  command into the LaTeX preamble and handle the figures in the standard
- LaTeX2e way.
+ LaTeX2e way, interspersing the figures in the text.
- Anyone who attempts to print your AASTeX 5.0 manuscript must have a LaTeX2e
+ I believe ApJ accepts figures exactly this way now; AJ might still use
- installation anyway, so why not take advantage of the infinitely better
+ the 
- graphics handling mechanism? If they complain about LaTeX2e or the graphics
+\begin_inset Quotes eld
- package, point out that it appears in the second edition of Lamport (1994),
+\end_inset 
- so it was time to upgrade many years ago.
+
+stack everything at the end
+\begin_inset Quotes erd
+\end_inset 
+
+ technique.
 \layout Subsubsection
 
 Things I could have done, but didn't
@@ -6163,43 +6120,19 @@ pretty
  styles.
  Since I assume you will spend most of your time in the plain manuscript
  mode anyway, I decided not to chew up more disk space with this.
- If you feel strongly that I should make such layouts, I will adhere to
- the spirit of the rules laid out by the Mudgeeraba Creek Emu-Riding and
- Boomerang-Throwing Association:
-\layout Quotation
-
-
-\begin_inset Quotes eld
-\end_inset 
-
-Decisions of the judges will be final unless shouted down by a really overwhelmi
-ng majority of the crowd present.
- Abusive and obscene language may not be used by contestants when addressing
- members of the judging panel, or, conversely, by members of the judging
- panel when addressing contestants (unless struck by a boomerang).
-\begin_inset Quotes erd
-\end_inset 
-
  
 \layout Subsection
 
 Final Caveat
 \layout Standard
 
-To mangle the infamous quote by Donald Knuth about a computer algorithm,
+Your mileage may vary.
- 
+ I've now had papers published by both ApJ and AJ that have had 98% of the
-\begin_inset Quotes eld
+ effort done in LyX; the last 2% was the LaTeX post-processing and a few
-\end_inset 
+ cleanups.
-
+ I have had no trouble with the submission process, and I'm sure the journals
-I have only proved this to be correct, I have not actually tried it.
+ were never aware that there might be a difference.
-\begin_inset Quotes erd
+ So, go forth and publish!
-\end_inset 
-
- I believe following the above procedures will produce an acceptable AASTeX
- document, but as of this update (Jan 25, 2000), I have not yet submitted
- a paper using it.
- Hopefully in the next few months \SpecialChar \ldots{}
-
 \layout Section
 
 ijmpd

lib/doc/FAQ.lyx

@@ -27,8 +27,6 @@
 \layout Title
 
 LyX Frequently Asked Questions with Answers 
-\newline 
-Version 0.3.7
 \layout Author
 
 by the LyX Team
@@ -37,13 +35,8 @@ collapsed false
 
 \layout Standard
 \noindent 
-Principal maintainer of this file is
+If you have comments or error corrections, please send them to the LyX Documenta
-\noun on 
+tion mailing list, <lyx-docs@lists.lyx.org>.
- Mike Ressler
-\noun default 
-.
- If you have comments or error corrections, please send them to the LyX
- Documentation mailing list, <lyx-docs@lists.lyx.org>.
 \end_inset 
 
  
@@ -1515,7 +1508,7 @@ Feedback is invited.
 Send comments, suggested additions, world record document claims, etc.
  to 
 \emph on 
-mike.ressler@alum.mit.edu.
+lyx-docs@lists.lyx.org.
 \layout Subsection
 
 Formats in which this FAQ is available.
@@ -1534,11 +1527,8 @@ Bernhard Iselborn, David Johnson, and Paul Evans were responsible for the
  FAQ through version 0.2.2 which covered LyX-0.10.7.
  The FAQ as of version 0.3.0 was written from scratch and covers LyX-1.0 and
  higher.
- Many people contributed pieces to the current version; Mike Ressler (
+ Many people contributed pieces to the current version; Mike Ressler of
-\emph on 
+ the Doc Team collected them into this file.
-mike.ressler@alum.mit.edu
-\emph default 
-) of the Doc Team is collecting them into this file.
 \layout Subsection
 
 Disclaimer and Copyright.

lib/doc/de_FAQ.lyx

@@ -27,8 +27,6 @@
 \layout Title
 
 LyX: Häufig gestellte Fragen mit Antworten
-\newline 
-Version 0.3.6
 \layout Author
 
 vom LyX Team
@@ -37,12 +35,7 @@ collapsed true
 
 \layout Standard
 \noindent 
-Diese Datei wird derzeit von 
+Deutsche Übersetzung 
-\noun on 
-Mike Ressler
-\noun default 
- betreut.
- Deutsche Übersetzung 
 \noun on 
 Peter Sütterlin.
 
@@ -1635,11 +1628,8 @@ Bernhard Iselborn, David Johnson und Paul Evans waren f
  zur Version 0.2.2 verantwortlich, die LyX Version 0.10.7 beschrieb.
  Mit der Version 0.3.0 wurde es komplett neu erstellt und behandelt ausschließlich
  die 1.x Versionen von LyX.
- Viele Personen haben Teile zu diesem Text beigetragen; Mike Ressler (
+ Viele Personen haben Teile zu diesem Text beigetragen; Mike Ressler vom
-\emph on 
+ Dokumentationsteam sammelt sie in diesem Dokument.
-mike.ressler@alum.mit.edu
-\emph default 
-) vom Dokumentationsteam sammelt sie in diesem Dokument.
 \layout Subsection
 
 Ausschluß und Copyright

lib/doc/eu_FAQ.lyx

@@ -30,8 +30,6 @@
 \layout Title
 
 LyX Maiz Eginiko Galderak
-\newline 
-0.3.7 bertsioa
 \layout Author
 
 egilea: LyX taldea.
@@ -40,13 +38,8 @@ collapsed false
 
 \layout Standard
 
-Fitxategi honen arduradun nagusia 
+Bidali iradokizunak edo erroreei buruzko zuzenketak LyX dokumentazioko posta-zer
-\noun on 
+rendara: <lyx-docs@lists.lyx.org>.
-Mike Ressler
-\noun default 
- da.
- Bidali iradokizunak edo erroreei buruzko zuzenketak LyX dokumentazioko
- posta-zerrendara: <lyx-docs@lists.lyx.org>.
  
 \newline 
 Itzulpena: Iñaki Larrañaga Murgoitio, <dooteo@euskalgnu.org>, 2004.
@@ -1566,11 +1559,7 @@ LyX-0.10.7 betetzen zuen MEG 0.2.2 bertsioaren egileak Bernhard Iselborn, David
  MEG 0.3.0 bertsio bezala hutsetik idazten hasi zen eta LyX-1.0 edo garatuagoak
  betetzen ditu.
  Pertsona askok lagundu dute uneko bertsioan; Dokumentazio-taldeko Mike
- Ressler-ek (
+ Ressler-ek guztiak bildu eta fitxategi honetan gorde zituen.
-\emph on 
-mike.ressler@alum.mit.edu
-\emph default 
-) guztiak bildu eta fitxategi honetan gorde zituen.
 \layout Subsection
 
 Ezespena eta Copyright-a.

lib/doc/fr_FAQ.lyx

@@ -27,8 +27,6 @@
 \layout Title
 
 Foire Aux Questions de LyX, avec les Réponses
-\newline 
-Version 0.3.7
 \begin_inset Note
 collapsed true
 
@@ -52,12 +50,7 @@ collapsed true
 
 \layout Standard
 
-Le principal responsable de la rédaction de ce fichier est 
+Merci d'envoyer vos commentaires et corrections à la liste de diffusion
-\noun on 
-Mike Ressler
-\noun default 
-.
- Merci d'envoyer vos commentaires et corrections à la liste de diffusion
  de la documentation de LyX, 
 \family typewriter 
 <lyx-docs@lists.lyx.org>
@@ -1697,7 +1690,7 @@ Votre avis est le bienvenu
 Envoyez des commentaires, des suggestions d'ajouts, ou l'annonce que vous
  avez battu un record du monde avec votre document, à 
 \emph on 
-mike.ressler@alum.mit.edu
+lyx-docs@lists.lyx.org
 \emph default 
 .
 \layout Subsection
@@ -1717,12 +1710,7 @@ Bernhard Iselborn, David Johnson et Paul Evans ont
  FAQ jusqu'à la version 0.2.2 qui traitait de LyX-0.10.7.
  À partir de la version 0.3.0 la FAQ a été entièrement réécrite et couvre
  LyX-1.0 et au-delà.
- Beaucoup de gens ont contribué à des morceaux de la version actuelle ;
+ Beaucoup de gens ont contribué à des morceaux de la version actuelle.
- Mike Ressler (
-\emph on 
-mike.ressler@alum.mit.edu
-\emph default 
-) de l'Équipe de Documentation les rassemble et les met dans ce fichier.
 \layout Subsection
 
 Garantie et Licence

lib/doc/pl_Extended.lyx

@@ -45,7 +45,7 @@ Opiekunem tego pliku jest aktualnie
 \noun on 
 Mike Ressler
 \noun default 
-, mike.ressler@alum.mit.edu.
+.
  Proszę wysyłać komentarze i poprawki błędów na podany adres.
 \end_inset 
 

lib/doc/ru_FAQ.lyx

@@ -29,8 +29,6 @@
 LyX.
  Часто задаваемые вопросы с ответами.
  
-\newline 
-Версия 0.3.6
 \layout Author
 
 от команды разработчиков LyX 
@@ -39,12 +37,7 @@ collapsed false
 
 \layout Standard
 \noindent 
-В настоящее время этот файл поддерживает 
+Пожалуйста, комментарии и исправления отсылайте по указанному адресу.
-\noun on 
-Mike Ressler
-\noun default 
-, mike.ressler@alum.mit.edu.
- Пожалуйста, комментарии и исправления отсылайте по указанному адресу.
 \layout Standard
 
 По русскому переводу замечания ожидаются Vitaly Lipatov по адресу <lav@altlinux.r
@@ -1473,7 +1466,7 @@ lists.lyx.org.
 Присылайте комментарии, предлагайте дополнения, образцы созданных документов
  по адресу 
 \emph on 
-mike.ressler@alum.mit.edu.
+lyx-docs@lists.lyx.org.
 \layout Subsection
 
 Форматы, в которых распространяется данный документ.
@@ -1503,11 +1496,8 @@ collapsed false
 Bernhard Iselborn, David Johnson, и Paul Evans отвечали за этот документ,
  начиная с версии 0.2.2, вошедшей в LyX-0.10.7.
  FAQ версии 0.3.0 был написан заново и вошёл в LyX-1.0 и старше.
- Много людей внесли толику своего труда в текущую версию; Mike Ressler (
+ Много людей внесли толику своего труда в текущую версию; Mike Ressler собрал
-\emph on 
+ всё это воедино.
-mike.ressler@alum.mit.edu
-\emph default 
-) собрал всё это воедино.
 \layout Subsection
 
 Disclaimer and Copyright.