home *** CD-ROM | disk | FTP | other *** search
/ InfoMagic Source Code 1993 July / THE_SOURCE_CODE_CD_ROM.iso / languages / elisp / interfaces / atavachron-1.1 / atavachron.info < prev    next >
Encoding:
GNU Info File  |  1993-01-18  |  46.3 KB  |  1,175 lines
  1. This is Info file atavachron.info, produced by Makeinfo-1.49 from the
  2. input file atavachron.texi.
  3.  
  4. 
  5. File: atavachron.info,  Node: Top,  Next: Copying Conditions,  Prev: (dir),  Up: (dir)
  6.  
  7.  
  8.  
  9.                             The Atavachron
  10.  
  11.                by James E. Hetrick <hetrick@phys.uva.nl>
  12.  
  13.    The *Atavachron* is an interface to the "Astro/Math/Physics"
  14. preprint archives from within the GNU Emacs editor. It gives the user a
  15. simple set of commands to get, store, process, and list papers with
  16. minimal effort.
  17.  
  18.    This Texinfo file is current to Version 1.1 and was compiled        
  19.   by James Hetrick and Marcus Speh.
  20.  
  21. * Menu:
  22.  
  23. * Copying Conditions::
  24. * General Description::
  25. * Configuration::
  26. * Batteries Not Included::
  27. * Functions::
  28. * Paper Formats::
  29. * Example Sessions::
  30. * Things To Come::
  31. * Index::
  32.  
  33.  -- The Detailed Node Listing --
  34.  
  35. Configuration
  36.  
  37. * Example .emacs File::
  38. * atv-main-ftp-site::
  39. * atv-download-dir::
  40. * atv-uufiles-dir::
  41. * atv-prompt-filename::
  42. * atv-interesting-file::
  43. * atv-auto-tex-paper::
  44. * atv-no-csh::
  45.  
  46. Batteries Not Included
  47.  
  48. * ange-ftp.el::
  49. * zcat.el::
  50. * .netrc::
  51. * .dvipsrc::
  52.  
  53. Functions
  54.  
  55. * Getting Papers::
  56. * Storing Papers::
  57. * Processing Functions::
  58. * Title Listings and Abstracts::
  59. * Utilities::
  60.  
  61. 
  62. File: atavachron.info,  Node: Copying Conditions,  Next: General Description,  Prev: Top,  Up: Top
  63.  
  64. Copying Conditions
  65. ******************
  66.  
  67.    This program is free software; you can redistribute it and/or modify
  68. it under the terms of the GNU General Public License as published by
  69. the Free Software Foundation.
  70.  
  71.    This program is distributed in the hope that it will be useful, but
  72. *without any warranty*; without even the implied warranty of
  73. *merchantability* or *fitness for a particular purpose*. See the GNU
  74. General Public License for more details.
  75.  
  76.    A copy of the GNU General Public License can be obtained from
  77.      Free Software Foundation, Inc.,
  78.      675 Mass Ave,
  79.      Cambridge, MA 02139, USA.
  80.  
  81.    Permission is granted to copy and distribute modified versions of
  82. this manual under the conditions for verbatim copying, provided that the
  83. entire resulting derived work is distributed under the terms of a
  84. permission notice identical to this one.
  85.  
  86. Obtaining This Package
  87. ======================
  88.  
  89.    At the time of writing (January 1993), the `atavachron' package is
  90. intended to be placed in the `macros' directory of the supported
  91. archives. Thus it should hopefully be accessible by February 1993
  92. through anonymous ftp or by electronic mail from your favorite preprint
  93. site.
  94.  
  95.    Copies will be submitted to `prep.ai.mit.edu' and
  96. `archive.cis.ohio-state.edu' for permenant archiving, and announcements
  97. will be made to the relevant Newsgroups (`gnu.emacs.source' and
  98. `sci.phys', at least).
  99.  
  100.    Of course, the latest version can always be obtained from the author
  101. directly at the address given in *note General Description::..
  102.  
  103. 
  104. File: atavachron.info,  Node: General Description,  Next: Configuration,  Prev: Copying Conditions,  Up: Top
  105.  
  106. General Description
  107. *******************
  108.  
  109.    The *Atavachron* (pronounced: a . TAV'. a . kron) is an intelligent
  110. interface or "Front End" to the scientific preprint archives from
  111. within emacs. The preprint archives supported are only those running
  112. Paul Ginsparg's (<ginsparg@qfwfq.lanl.gov>) Preprint Bulletin Board
  113. software. At present the supported archives are:
  114.  
  115.    `alg-geom:' Algebraic Geometry
  116.  
  117.    `astro-ph:' Astrophysics
  118.  
  119.    `cond-mat:' Condensed Matter Physics
  120.  
  121.    `funct-an:' Functional Analysis
  122.  
  123.    `gr-qc:   ' General Relativity and Quantum Cosmology
  124.  
  125.    `hep-lat: ' High Energy Physics -- Lattice
  126.  
  127.    `hep-ph:  ' High Energy Physics -- Phenomenology
  128.  
  129.    `hep-th:  ' High Energy Physics -- Theory
  130.  
  131.    `lc-om:   ' Liquid Crystals
  132.  
  133.    `math-ph: ' Mathematical Physics (at babbage.sissa.it)
  134.  
  135.    `nucl-th: ' Nuclear Theory
  136.  
  137.    Should you wish to add another archive please contact the author (via
  138. `atavachron-mail' if you like *note Utilities::.). Supporting other
  139. disciplines which use TeX as their main typesetting format would be
  140. very simple and rewarding.
  141.  
  142.    The *Atavachron* gives its user a simple set of commands to get,
  143. store, process, and list papers which can be called from the
  144. `mini-buffer' (the bottom most, one line window in Emacs used for
  145. command input and message output). The key strokes: `M-x' invoke Emacs
  146. functions; on most keyboards, `M' is `ESC'. The package is easily
  147. loaded via your `.emacs' file (*note Configuration::.) and then
  148. provides several functions which can be called at any time.
  149.  
  150.    The *Atavachron*'s user functions are listed here and described
  151. below (*note Functions::.):
  152.  
  153.      get-paper
  154.      get-paper-from-data
  155.      store-paper
  156.      store-paper-from-data
  157.      process-paper
  158.      slice-and-dice
  159.      shell-paper
  160.      get-listing-from-data
  161.      store-listing-from-data
  162.      get-abstract
  163.      get-abstract-from-data
  164.      interesting
  165.      atavachron-mail
  166.  
  167.    You must go through *Note Configuration::, and *Note Batteries Not
  168. Included::, and set things appropriately for your system.  The variables
  169. to be set govern such things as where papers gotten with `get-paper'
  170. are put, whether they are renamed, and the address of your default
  171. archive.
  172.  
  173.    Note that the documentation here is meant to be somewhat pedagogical
  174. for new users to Emacs. If you are such a user, your comments on the
  175. accessibility of this manual would be most appreciated.
  176.  
  177.    `atavachron.el' requires `ange-ftp.el' for retrieving files across
  178. the network. In addition there are auxiliary files used by the
  179. *Atavachron* which greatly enhance its abilities. The purpose of these
  180. files is described in *Note Batteries Not Included::.
  181.  
  182.    If you find bugs, please report them; this is very easy with the
  183. function `atavachron-mail'. You're welcome to use this function for
  184. other correspondence as well (*Note Utilities::).
  185.  
  186. Why "Atavachron"?
  187. .................
  188.  
  189.    This package was originally named `pp-tools.el' in its development
  190. stage, when a previously existing "pp-tools" package turned up in a
  191. network search. Thus the name had to be changed.
  192.  
  193.    The name *Atavachron* comes from the original "Star Trek" series, in
  194. the episode "All Our Yesterdays". Kirk, Spock, and McCoy beam down to a
  195. planet with this wonderful library. Library users place disks into
  196. viewers which show images from periods of the planet's past. The
  197. library also has a portal through which users can travel backwards in
  198. time (for various reasons which probably included research).
  199.  
  200.    All the disk viewers are interfaced to a machine called the
  201. *Atavachron* which senses which disk the user was viewing and
  202. configures the portal such that when the user steps through, he passes
  203. into the corresponding period of time.
  204.  
  205.    Due to the similarities in functionality between the present package
  206. and the 23rd century's archive interface (at least to the imaginative
  207. mind), the name *Atavachron* seemed appropriate.
  208.  
  209. Acknowledgements
  210. ................
  211.  
  212.    Many thanks to Paul Ginsparg, Greg Kilcup, Marcus Speh, and Bas de
  213. Bakker for ongoing discussions, suggestions, and beta tests.
  214.  
  215.    The text for the first edition of this document was taken from the
  216. text description distributed with version 1.3 of `pp-tools' and set
  217. into Texinfo by Marcus Speh (If you don't have Texinfo, you can obtain
  218. it from `prep.ai.mit.edu' via anonymous FTP).
  219.  
  220.    The change over to the *Atavachron* package version 1.1 and
  221. documentation of subsequent additions to the source has been mostly
  222. done by Jim Hetrick.
  223.  
  224. Author's address:
  225. .................
  226.  
  227.      James E. Hetrick            Institute for Theoretical Physics
  228.      hetrick@phys.uva.nl                     -\|/-
  229.      University of Amsterdam
  230.      Valckenierstraat 65, 1018 XE Amsterdam
  231.      Telephone: +31 20 525 5772     Fax: +31 20 525 5788
  232.  
  233. 
  234. File: atavachron.info,  Node: Configuration,  Next: Batteries Not Included,  Prev: General Description,  Up: Top
  235.  
  236. Configuration
  237. *************
  238.  
  239.    This node describes the variables which configure the *Atavachron*
  240. within Emacs. "Configuring" means setting environment variables for
  241. Emacs.  These definitions are usually put into Emacs' initialization
  242. file `.emacs'. If you want to try them out, you may use any buffer in
  243. `Emacs-lisp' mode, then use `(M-x) eval-buffer', but remember that
  244. `atavachron.el' should really be reloaded everytime you change the
  245. configuration.
  246.  
  247.    For users new to Emacs, there are two types of variables used below.
  248. Strings, which must be enclosed by "'s, are used for directories,
  249. archive sites, and so forth. The other kind is a logical variable which
  250. is either "t" (true or ON) or "nil" (false or OFF). Logical variables
  251. are *not* enclosed in quotations.
  252.  
  253. * Menu:
  254.  
  255. * Example .emacs File::
  256. * atv-main-ftp-site::
  257. * atv-download-dir::
  258. * atv-uufiles-dir::
  259. * atv-prompt-filename::
  260. * atv-interesting-file::
  261. * atv-auto-tex-paper::
  262. * atv-no-csh::
  263.  
  264. 
  265. File: atavachron.info,  Node: Example .emacs File,  Next: atv-main-ftp-site,  Up: Configuration
  266.  
  267. Example `.emacs' File
  268. =====================
  269.  
  270.    Below is an example `.emacs' file which loads `atavachron.el' and
  271. the batteries, then sets the `atv-'variables to their defaults.
  272. *Please* go through each variable and set it according to your own
  273. directory structure and preferences.
  274.  
  275.    Regarding `ange-ftp.el', the simplest method of loading has been
  276. given here, for the case in which it has not been loaded previously in
  277. your `.emacs' file. If it is loaded previously be sure to delete the
  278. `(load-library '"ange-ftp")' line here, so as not to load it twice.
  279. Since `atavachron.el' contains the `require 'ange-ftp', users of more
  280. advanced auto-loading techniques may keep their mechanisms intact.
  281.  
  282.    Although not discussed here, any *Atavachron* function can be bound
  283. to a key sequence or mouse button action. Such bindings should go here
  284. as well. See the Emacs manual on key rebinding and the documentation of
  285. your mouse interface for more details.
  286.  
  287.      ; ====================.emacs stuff ========================
  288.      
  289.      (load-library '"ange-ftp")  ;see ange-ftp docs for more details
  290.      (setq ange-ftp-generate-anonymous-password t) ; sends email address
  291.                                                    ; for password
  292.      (load-library '"zcat")
  293.      (load-library '"atavachron")
  294.      
  295.      (setq atv-main-ftp-site "/anonymous\@babbage.sissa.it:") ;Europeans
  296.      ;;(setq atv-main-ftp-site "/anonymous\@xxx.lanl.gov:")  ;N+S Americans
  297.      
  298.      (setq atv-download-dir "~/tex/preprints/")   ;default download directory
  299.      (setq atv-uufiles-dir "~/tex/preprints/")    ;default place for uu output
  300.      (setq atv-prompt-filename t)              ;prompt to rename paper locally
  301.      (setq atv-interesting-file "~/interesting.atv") ;file for interesting abs.
  302.      (setq atv-auto-tex-paper nil)     ;run tex on paper grabbed automatically
  303.      (setq atv-auto-tex-command 'TeX-buffer)        ;command to run on buffer
  304.      (setq atv-no-csh nil)                     ;set to t if you don't have csh
  305.      
  306.      ; ==========================================================
  307.  
  308. 
  309. File: atavachron.info,  Node: atv-main-ftp-site,  Next: atv-download-dir,  Prev: Example .emacs File,  Up: Configuration
  310.  
  311. `atv-main-ftp-site'
  312. ===================
  313.  
  314.      ; ====================.emacs stuff =======================
  315.       (setq atv-main-ftp-site "/anonymous\@babbage\.sissa\.it:"); Europeans
  316.      ;; (setq atv-main-ftp-site "/anonymous\@xxx\.lanl\.gov:")  ; N+S Americans
  317.      ; ======================================================== ; Others chose one
  318.  
  319.    Uncomment one of these as your main archive. Branches not supported
  320. at `xxx.lanl.gov', such as "cond-mat", are retrieved from
  321. `babbage.sissa.it'. Papers on "hep-lat", "alg-geom", etc. which are not
  322. mirrored at the above two sites are automatically gotten >from their
  323. respective archives at present.
  324.  
  325. 
  326. File: atavachron.info,  Node: atv-download-dir,  Next: atv-uufiles-dir,  Prev: atv-main-ftp-site,  Up: Configuration
  327.  
  328. `atv-download-dir'
  329. ==================
  330.  
  331.      ; ====================.emacs stuff =======================
  332.      (setq atv-download-dir "~/tex/preprints/")    ;default download directory
  333.      (setq atv-uufiles-dir "~/tex/preprints/")     ;default place for uu output
  334.      ; ========================================================
  335.  
  336.    This is your local download workspace. Upon "getting" a paper, the
  337. default directory is reset to `atv-download-dir' so that saves put
  338. files there. In addition tarred papers (archived and compressed as
  339. .tar.Z files), and script papers (papers which are shell scripts to be
  340. executed) are processed in this directory so that any files unpacked end
  341. up there.
  342.  
  343.    If you have branch directories  "hep-th", "hep-lat", "astro-ph", etc.
  344. below `atv-download-dir', papers, when saved, will automatically be put
  345. there, sorted by branch. For example, your `atv-download-dir' is set to
  346. `~/tex/preprints/' and you have the subdirs `~/tex/preprints/hep-th/'
  347. and `~/tex/preprints/cond-mat/'. Then getting "hep-th/91120013" will
  348. put the file in `tex/preprints/hep-th/'. Getting "cond-mat/920106" will
  349. put it in `tex/preprints/cond-mat/'. If these subdirs do not exist below
  350. `tex/preprints/', both papers would be put in `tex/preprints/'. The
  351. recognition of branched subdirectories is mainly provided for very
  352. heavy or library related use.
  353.  
  354.    Be sure to put this directory (and branches) in your TEXINPUTS
  355. environment variable so that tex can get at your newly gotten files.
  356.  
  357. 
  358. File: atavachron.info,  Node: atv-uufiles-dir,  Next: atv-prompt-filename,  Prev: atv-download-dir,  Up: Configuration
  359.  
  360. `atv-uufiles-dir'
  361. =================
  362.  
  363.    This is where uuencoded files will be unpacked. It should usually be
  364. the same as `atv-download-dir', unless you have a good reason to put the
  365. figures elsewhere [your "dvi --> ps" processor can't get at them in
  366. `atv-download-dir', for instance. (in which case you should get
  367. `dvips')]. If it's the same as `atv-download-dir', it will adjust
  368. itself to the branched subdirectory structure following
  369. `atv-download-dir'.
  370.  
  371. 
  372. File: atavachron.info,  Node: atv-prompt-filename,  Next: atv-interesting-file,  Prev: atv-uufiles-dir,  Up: Configuration
  373.  
  374. `atv-prompt-filename'
  375. =====================
  376.  
  377.      ; ====================.emacs stuff =======================
  378.      (setq atv-prompt-filename t)        ; prompt to rename paper locally
  379.      ; ========================================================
  380.  
  381.    This one toggles prompting for a local name for the grabbed paper or
  382. listing. When "t" (true), you are prompted to name the incoming archive
  383. file which is then appended with `.tex'. Hitting return at the prompt
  384. will accept the default given in parenthesis. If "nil" the paper is
  385. named by its paper number.
  386.  
  387. 
  388. File: atavachron.info,  Node: atv-interesting-file,  Next: atv-auto-tex-paper,  Prev: atv-prompt-filename,  Up: Configuration
  389.  
  390. `atv-interesting-file'
  391. ======================
  392.  
  393.      ; ===========================================
  394.      (setq atv-interesting-file "~/interesting.atv")  ; file for interesting
  395.      ; ===========================================  ; abstracts.
  396.  
  397.    The default file to which abstracts stored with `interesting'
  398. function are appended (*note Utilities::.). You are prompted for a file
  399. name to append the interesting abstract to, and offered
  400. `atv-interesting-file' as the default.
  401.  
  402.    I find it useful to put this file in a directory other than
  403. `atv-download-dir' since I regularly clean `atv-download-dir' with `rm
  404. *'.
  405.  
  406. 
  407. File: atavachron.info,  Node: atv-auto-tex-paper,  Next: atv-no-csh,  Prev: atv-interesting-file,  Up: Configuration
  408.  
  409. `atv-auto-tex-paper'
  410. ====================
  411.  
  412.      ; ====================.emacs stuff =======================
  413.      (setq atv-auto-tex-paper nil)    ; run tex on paper grabbed automatically
  414.      (setq atv-auto-tex-command 'TeX-buffer)  ; command to run on buffer
  415.      ; ========================================================
  416.  
  417.    Setting `atv-auto-tex-paper' to "t", automatically starts the tex
  418. processor as given by the function `atv-auto-tex-command' on the paper
  419. once it's loaded into a local buffer, provided no shell command signal
  420. is found. The default is that auto-texxing is OFF.
  421.  
  422.    Note that adding auto-previewing is quite simple as well (e-mail for
  423. details), and will impress your friends if the paper texs, but is not
  424. really all that useful since many papers don't pass the texxing stage,
  425. as you probably know! As this changes, and authors submit standardized
  426. TeX, auto-tex/preview could become useful.
  427.  
  428.    Originally provided as extra frill, these variables can actually be a
  429. powerful expansion slot. You can supply any function you like for
  430. `atv-auto-tex-command', in particular your own custom ones. Thus after
  431. processing all auxillary files and getting the primary TeX file,
  432. `atv-auto-tex-command' provides a final hook to execute custom
  433. processing.
  434.  
  435. 
  436. File: atavachron.info,  Node: atv-no-csh,  Prev: atv-auto-tex-paper,  Up: Configuration
  437.  
  438. `atv-no-csh'
  439. ============
  440.  
  441.      ; ====================.emacs stuff =======================
  442.      (setq atv-no-csh nil)            ; set to t if you don't have csh
  443.      ; ========================================================
  444.  
  445.    Setting this variable to "t" will replace the `/bin/csh' in the
  446. grabbed uufile to `/bin/sh', making it possible to unpack the figure
  447. files even if you don't have `csh' on your machine. If you use this
  448. feature, please read the copyright *Note Copying Conditions:: now,
  449. especially where it says:
  450.  
  451.    "This program is distributed in the hope that it will be useful, but
  452. *without any warranty*..."
  453.  
  454. 
  455. File: atavachron.info,  Node: Batteries Not Included,  Next: Functions,  Prev: Configuration,  Up: Top
  456.  
  457. Batteries Not Included
  458. **********************
  459.  
  460.    Here we discuss the other files needed or recommended for smooth
  461. operation of `atavachron.el'. The only one absolutely required is
  462. `ange-ftp.el', however you'll have to decipher a compressed binary file
  463. if you get a month old paper without `zcat.el'. The files `.netrc' and
  464. `.dvipsrc' eliminate the seams at the connections to the network and
  465. TeX.
  466.  
  467.    Loading the elisp (`.el') files in your `.emacs' file is discussed
  468. in *Note Configuration::.
  469.  
  470. * Menu:
  471.  
  472. * ange-ftp.el::
  473. * zcat.el::
  474. * .netrc::
  475. * .dvipsrc::
  476.  
  477. 
  478. File: atavachron.info,  Node: ange-ftp.el,  Next: zcat.el,  Up: Batteries Not Included
  479.  
  480. `ange-ftp.el'
  481. =============
  482.  
  483.    * This file is available via anonymous FTP from
  484. `archive.cis.ohio-state.edu' in directory
  485. `/pub/gnu/emacs/elisp-archive/packages/'.
  486.  
  487.    `atavachron.el' requires Andy Norman's essential ftp interface
  488. `ange-ftp.el' to do the remote file teleportation If you don't have
  489. this loaded in your `.emacs' file, you must get it. Check locally if
  490. you have it (perhaps in `/usr/local/emacs/lisp' or there abouts?), or
  491. convince your system administrator to install it (or do it yourself).
  492.  
  493. 
  494. File: atavachron.info,  Node: zcat.el,  Next: .netrc,  Prev: ange-ftp.el,  Up: Batteries Not Included
  495.  
  496. `zcat.el'
  497. =========
  498.  
  499.    * This file is included in the `atavachron' distribution package.
  500.  
  501.    Another file needed is Graham Gough's `zcat.el' which uncompresses
  502. `.Z' files on the fly. This makes loading older papers which are
  503. compressed at the archive transparent. Since it's short it's included
  504. with the distribution package of `atavachron'.
  505.  
  506. 
  507. File: atavachron.info,  Node: .netrc,  Next: .dvipsrc,  Prev: zcat.el,  Up: Batteries Not Included
  508.  
  509. `.netrc'
  510. ========
  511.  
  512.    * You can easily write your own `.netrc' file, see example below.
  513.  
  514.    Ange-ftp will work much smoother if you keep a `.netrc' file in your
  515. home directory, thus bypassing the need to send the "anonymous" login
  516. and email address when ftping into the archive. Simply clip out the
  517. following and name it `~/.netrc'. Remember to put your email address in
  518. for you@where.you.are).
  519.  
  520. sample `.netrc'
  521. ...............
  522.  
  523.      #   --------------------.netrc sample -----------------------
  524.      machine ftp.scri.fsu.edu login anonymous password you@where.you.are
  525.      machine xxx.lanl.gov login anonymous password you@where.you.are
  526.      machine babbage.sissa.it login anonymous password you@where.you.are
  527.      machine publications.math.duke.edu login anonymous password you@where.you.are
  528.      machine alcom-p.cwru.edu login anonymous password you@where.you.are
  529.      #   ---------------------------------------------------------
  530.  
  531.    Furthermore, it must be a protected file. Run: `chmod go-rwx .netrc'
  532. on it once it has been created.
  533.  
  534. 
  535. File: atavachron.info,  Node: .dvipsrc,  Prev: .netrc,  Up: Batteries Not Included
  536.  
  537. `.dvipsrc'
  538. ==========
  539.  
  540.    * You can easily write your own `.dvipsrc' file, see example below.
  541.  
  542.    Finally, if you use `dvips' as your ".dvi --> .ps" processor, put
  543. your `atv-download-dir' and `atv-uufiles-dir' (*note Configuration::.)
  544. in its path by keeping a `.dvipsrc' file in your home directory with
  545. the following lines:
  546.  
  547. sample `.dvipsrc'
  548. .................
  549.  
  550.      # -------------------.dvipsrc sample ---------------------
  551.      S ~/tex/preprints:
  552.      H ~/tex/preprints:
  553.      W "reading your .dvipsrc file"
  554.      # --------------------------------------------------------
  555.  
  556.    The trailing `:''s above add the default paths to the path list. A
  557. line beginning with `W' echos the following string.
  558.  
  559.    Having `atv-download-dir' and `atv-uufiles-dir' in both your `dvips'
  560. path and your TEXINPUTS environment variable (or whatever the path to
  561. TeX input and style files is named on your local machine) allows
  562. `dvips' and TeX to access your new figure files.
  563.  
  564.    For more info, see your man pages on TeX and `dvips' or your system
  565. administrator, whichever is friendlier.
  566.  
  567. 
  568. File: atavachron.info,  Node: Functions,  Next: Paper Formats,  Prev: Batteries Not Included,  Up: Top
  569.  
  570. Functions
  571. *********
  572.  
  573.    This section describes the functions available to the user for
  574. interacting with the archive. In addition three example sessions are
  575. displayed in *Note Example Sessions::, where the reader can get a quick
  576. feel for the operation of the *Atavachron* on different types of papers.
  577.  
  578. * Menu:
  579.  
  580. * Getting Papers::
  581. * Storing Papers::
  582. * Processing Functions::
  583. * Title Listings and Abstracts::
  584. * Utilities::
  585.  
  586. 
  587. File: atavachron.info,  Node: Getting Papers,  Next: Storing Papers,  Up: Functions
  588.  
  589. Getting Papers
  590. ==============
  591.  
  592.    The following functions get an archive paper to an Emacs buffer (or
  593. buffers if it is distributed in several files). After the paper is in a
  594. local buffer, action appropriate to the format of the paper is taken.
  595. For instance, a tar file is uncompressed and unpacked, or uu encoded
  596. files are decoded, as described below in *Note Paper Formats::.
  597.  
  598.    * Function: get-paper
  599.  
  600.    When reading an abstract listing in emacs, either in one of the mail
  601. readers or as a previously saved file (output by Unix Mail perhaps),
  602. placing the point (cursor) anywhere in the abstract of choice (after the
  603. line beginning with `Paper'), and typing: `M-x get-paper' automatically
  604. opens an ftp socket into the right archive (via `ange-ftp.el'),
  605. transfers the paper, uncompresses it if necessary (via `zcat.el'), and
  606. loads it into a `tex-mode' buffer for [La]TeXing, previewing, and
  607. printing by the usual `tex-mode' facilities.
  608.  
  609.    First though, the *Atavachron* performs a number of tests to
  610. determine the format in which the paper is stored at the archive. These
  611. steps are also performed by `process-paper' if it is called on a stored
  612. paper (See *Note Processing Functions::, *Note Storing Papers::.) Once
  613. its format is determined, appropriate action is taken based on the
  614. configuration variables (*note Configuration::.). The description of the
  615. paper formats supported in the present version (1.1) is given below (see
  616. *note Paper Formats::.).
  617.  
  618.    If `atv-prompt-filename' is "t" (true), one is prompted to give a
  619. local name to the incoming paper, and the paper is renamed
  620. `localname.ext', where `.ext' depends on the format of the paper.
  621.  
  622.    The buffer(s) containing the paper are marked as changed so that you
  623. will be prompted to save it if you try to delete it.
  624.  
  625.    * Function: get-paper-from-data
  626.  
  627.    This function works exactly like `get-paper' except that it promps
  628. the user to input the paper's data in the usual format:
  629.      cond-mat/9212003
  630.      hep-lat/9212005
  631.      etc.
  632.  
  633. 
  634. File: atavachron.info,  Node: Storing Papers,  Next: Processing Functions,  Prev: Getting Papers,  Up: Functions
  635.  
  636. Storing Papers
  637. ==============
  638.  
  639.    * Function: store-paper
  640.  
  641.    * Function: store-paper-from-data
  642.  
  643.    `Store-paper', and `store-paper-from-data', work the same as
  644. `get-paper' and `get-paper-from-data', except that the paper is stored
  645. directly to the user's default download directory (*note
  646. Configuration::.) for later processing. This is convenient when reading
  647. the abstracts remotely (on the weekend from home, say) when one wants
  648. to save processing and printing the tex file for later, or so that the
  649. file can be further downloaded via modem. (*note Example Sessions::.)
  650.  
  651. 
  652. File: atavachron.info,  Node: Processing Functions,  Next: Title Listings and Abstracts,  Prev: Storing Papers,  Up: Functions
  653.  
  654. Processing Functions
  655. ====================
  656.  
  657.    Three functions are presently provided for operating on preprint
  658. files individually. These are stand alone versions of functions which
  659. are called by `get-paper' and are useful for processing stored papers
  660. or individual buffers of a multifile paper.
  661.  
  662.    In addition, the descriptions of the Emacs functions `buffer-menu'
  663. and `insert-buffer' are included for completeness; they are quite
  664. useful when a retrieved paper consists of several files which must be
  665. processed.
  666.  
  667. Stand Alone Internal Functions
  668. ------------------------------
  669.  
  670.    * Function: process-paper
  671.  
  672.    Use this function on a paper that has been stored locally with
  673. `store-paper' (*note Storing Papers::.) to invoke the functions which
  674. determine the paper's format (*note Paper Formats::.) and execute
  675. processing accordingly.
  676.  
  677.    For example, you have stored a particular paper with the local name
  678. `jones' earlier. `process-paper' will ask for the file name to be
  679. processed, `jones' in this case, then examine this file (or files) in
  680. `atv-download-dir' to determine its format. Having deduced this it
  681. takes appropriate action such as stripping appended PostScript figures,
  682. executing shell scripts, etc. For more details see *Note Paper
  683. Formats::, and *Note Example Sessions::.
  684.  
  685.    * Function: slice-and-dice
  686.  
  687.    `slice-and-dice' extracts appended PostScript figures from a file
  688. which is loaded in the current buffer. It will search for each occurance
  689. of `"^%!"' and strip the region between this line and the next `"^%!"'
  690. or the end of file. For each such region it pauses for the filename to
  691. be given to the figure, offering a default (in parenthesis) gathered
  692. from the comment area preceeding the PostScript signal.
  693.  
  694.    * Function: shell-paper
  695.  
  696.    This function is the one called when the retrieved paper is found to
  697. contain the regexp `"^#![ \t]*\\(.*/bin/.*\\)$"'. Everything below and
  698. including this line is extracted to a file `localname.sh' which is then
  699. executed by Emacs with `shell-command "(match) localname.sh"', where
  700. (match) is the executable shell name and path extracted from the file.
  701. Thus a variety of shells are supported, includng for instance, "Perl"
  702. scripts. A file `localname.rpt' is made which catches any standard
  703. output of the execution.
  704.  
  705.    You can use this function on any buffer containing a non-interactive
  706. shell script, like a shar file sent to you in the mail. `shell-paper'
  707. strips the header and executes the shar file without leaving mail.
  708. Remember that the script is executed in `atv-download-dir'.
  709.  
  710. Operating on Several Buffers in Emacs
  711. -------------------------------------
  712.  
  713.    * Command: buffer-menu
  714.  
  715.    See: *note Manipulating Several Buffers in Emacs: (emacs)Several
  716. Buffers.
  717.  
  718.    The "buffer-menu" facility is like a "Dired for buffers"; it allows
  719. you to request operations on various Emacs buffers by editing an Emacs
  720. buffer containing a list of them.  You can save buffers, kill them
  721. (here called "deleting" them, for consistency with Dired), or display
  722. them.
  723.  
  724.    Also the command `insert-buffer' is very useful for concatenating
  725. buffers of multifile papers.
  726.  
  727.    * Command: insert-buffer FROM-BUFFER-OR-NAME
  728.  
  729.    See: *note Inserting Whole Buffers: (elisp)Commands for Insertion.
  730.  
  731. 
  732. File: atavachron.info,  Node: Title Listings and Abstracts,  Next: Utilities,  Prev: Processing Functions,  Up: Functions
  733.  
  734. Title Listings and Abstracts
  735. ============================
  736.  
  737.    * Function: get-listing-from-data
  738.  
  739.    * Function: store-listing-from-data
  740.  
  741.    `get-listing-from-data' and `store-listing-from-data' work the same
  742. way, except on title listings. They prompt the user for the listing in
  743. the usual format: `hep-th/9204', then "get" (to a buffer), or "store"
  744. (to a file) the given month's listing.
  745.  
  746.    Note that if the listing is gotten with `get-listing-from-data' into
  747. a buffer, then `get-paper' will work in that buffer as in the daily
  748. abstract list. Simply put the cursor on the paper of interest (*after*
  749. the line beginning with "Paper:" and type `(M-x:) get-paper'.
  750.  
  751.    * Function: get-abstract
  752.  
  753.    * Function: get-abstract-from-data
  754.  
  755.    These two functions get abstracts to a new window and are useful in
  756. two situations mainly: use `get-abstract' when reading a monthly title
  757. listing where just the titles are given, to get the paper's abstract.
  758. `get-abstract-from-data' is handy to view the abstract of a reference
  759. for which you have the archive number.
  760.  
  761. 
  762. File: atavachron.info,  Node: Utilities,  Prev: Title Listings and Abstracts,  Up: Functions
  763.  
  764. Utilities
  765. =========
  766.  
  767.    * Function: interesting
  768.  
  769.    This function is a tool for saving interesting abstracts to a file
  770. which can then be examined sometime later. It is used to avoid having
  771. to save the entire Mail abstract posting, and then later sifting
  772. through all abstracts. It can also be used to save abstracts to
  773. different files according to subject, etc.
  774.  
  775.    When the point is placed in an abstract, type `M-x: interesting'.
  776. You are presented with the prompt to save the abstract to the default
  777. interesting file,
  778.      >>> Append to? (interesting.atv):
  779.  
  780.    `[RETURN]' saves to the default, set by `atv-interesting-file'
  781. (*note atv-interesting-file::.), or you may enter another filename.
  782.  
  783.    * Function: atavachron-mail
  784.  
  785.    This handy function allows you to easily send a bug report, comment,
  786. or question to the author. It opens a mail buffer addressed to me ("Jim
  787. Hetrick)" and dumps the current values of all *Atavachron* variables,
  788. which can be used to reconstruct your situation. Please feel free to
  789. use this function any time you would like to contact me with questions,
  790. suggestions, or other correspondence.
  791.  
  792. 
  793. File: atavachron.info,  Node: Paper Formats,  Next: Example Sessions,  Prev: Functions,  Up: Top
  794.  
  795. Paper Formats
  796. *************
  797.  
  798.    The paper formats presently supported by the *Atavachron* version
  799. `1.1' are listed here with a brief desription of the action taken for
  800. each (see *Note Processing Functions::, for more). The paper's format
  801. is determined by listing all files which match the paper's number in
  802. the correct branch directory at the archive.
  803.  
  804. Single TeX File
  805. ===============
  806.  
  807.    If the paper is a single file and no "PostScript" signal or shell
  808. commands are found, the paper is renamed `localname.tex' upon transfer
  809. to a local buffer, and `tex-mode' is loaded. It is then ready for
  810. processing via the usual `tex-mode' facilities,
  811.  
  812.      * `C-c C-b' for [La]TeXing,
  813.      * `C-c C-p' for printing,
  814.  
  815.    or any other local tex or `auc-tex' features, such as previewing. If
  816. `atv-auto-tex-paper' is "t", [La]TeX is automatically started at this
  817. point.
  818.  
  819. Single TeX File with Appended "PostScript" Figures
  820. ==================================================
  821.  
  822.    A single paper file is first checked for any appended "PostScript"
  823. figures, which are then surgically removed to `.ps' files at the user's
  824. request (*note Processing Functions::.). The whole file is first saved
  825. though, with extension `.tpl'. The `slice-and-dice' function (which
  826. removes the figures) tries to find a name for the figure file from the
  827. comments near the top of the "PostScript" header.
  828.  
  829.    With the advent of the bulletin board macro `uufiles' to package
  830. figures, data files, or other auxiliary files, the occurance of
  831. "all-in-one" papers will hopefully deminish.
  832.  
  833. Shell Script
  834. ============
  835.  
  836.    After checking for "PostScript" signs, the *Atavachron* checks for
  837. shell commands, in particular for `"#!.*/bin/"'. If this string is
  838. found, the region below `#!.*/bin/' is saved to a file `localname.sh'
  839. which is then executed (*note Processing Functions::.). A report of the
  840. execution (including any terminal output made by the script) is made
  841. and named `localname.rpt'.
  842.  
  843. Tar File
  844. ========
  845.  
  846.    If the archive paper is a tarfile, it is renamed `localname.tar.Z'
  847. and, upon confirmation, unpacked in `atv-download-dir'. A report of any
  848. output during the unpacking process is presented in the buffer
  849. `localname.rpt' which is then searched for a unique TeX file. If found
  850. this file is loaded to a buffer.
  851.  
  852. Multiple Archive Files for a Paper
  853. ==================================
  854.  
  855.    * UUENCODED Auxillary Files (Figures, Data, etc.)
  856.  
  857.    When the *Atavachron* finds multiple files for a given paper, it
  858. first checks for the extention `.2' and if found, assumes sequential
  859. integer extensions for all files. The paper files `localname.2' through
  860. `localname.N' are copied and checked as to whether they are *uuencoded*
  861. files produced by Paul Ginsparg's preprint bulliten board macro
  862. `uufiles'. If so, they are *uudecoded*, ie.  their contents is unpacked
  863. in `atv-uufiles-dir'. The figure files should then be accessible to TeX
  864. and `dvips' via the paths specified in the environment variable
  865. TEXINPUTS and in the file `.dvipsrc' (see *note .dvipsrc::.). If `csh'
  866. is not available on your machine, you can set `atv-no-csh' to "t"
  867. (*note Configuration::.) and still unpack the uufiles.
  868.  
  869.    A file named `localnameN.rpt' is produced in `atv-uufiles-dir' for
  870. each auxillary file, which records the output of the command `tar -xvf
  871. -' when unpacking (each of the N) uufiles. This file is then a manifest
  872. of figures/files included with this paper.
  873.  
  874.    * NON-UUENCODED Files
  875.  
  876.    If the extra archive files are not found to be *uufiles*, or they do
  877. not have sequential integer extensions, they are simply copied to
  878. separate Emacs buffers to be processed by hand. To facilitate this,
  879. `list-buffers' is called which lists all the buffers of the current
  880. session in "buffer-menu-mode" which makes working with several buffers
  881. much easier (*note Processing Functions::.).
  882.  
  883.    Finally, `localname.1' is transfered and treated as the primary file
  884. of the paper. Thus it is assumed to be a TeX document (although tests
  885. for "PostScript" and shell commands are automatically done), and will
  886. either make use of the decoded uufiles, or hopefully contain
  887. instructions for manually processing the set of files displayed by
  888. `list-buffers'.
  889.  
  890. Multiple Non-Integer Extensions
  891. ===============================
  892.  
  893.    If multiple files with non-integer extensions are found or if the
  894. *Atavachron* is confused about the nature of the files on the remote
  895. archive, the files are stored directly on the user's system in
  896. `atv-download-dir'; these files will in general require conscious
  897. processing.
  898.  
  899. 
  900. File: atavachron.info,  Node: Example Sessions,  Next: Things To Come,  Prev: Paper Formats,  Up: Top
  901.  
  902. Example Sessions
  903. ****************
  904.  
  905.    This section shows some sample sessions of what should happen when
  906. getting specific papers of various formats. These are intended to
  907. illustrate the most common formats and certainly do not exaust the
  908. permutations of papers and functions. Below, `>>>' means that the
  909. following prompt or message appears in the mini-buffer.
  910.  
  911. Example:  Single TeX File
  912. =========================
  913.  
  914.    The point is located in the abstract of Witten's paper
  915. "hep-th/9204083". If `atv-prompt-filename' is "t", doing
  916.      M-x get-paper
  917.  
  918.    asks:
  919.      >>>   Local name for paper? [.tex appended] (9204083):
  920.  
  921.    Typing "witten", renames this paper to `witten.tex', while simply
  922. hitting `[RETURN]', preserves it's archive name and adds `.tex'
  923. yielding the buffer `9204083.tex'. Note that as an older paper it is
  924. compressed at the archive, so `9204083.Z' is transferred and
  925. uncompressed on the fly.
  926.  
  927.    The file is gotten to a new window in `tex-mode'. Now typing `C-c
  928. C-b' ("Control and c" then "Control and b"), invokes TeX on the file,
  929. and `C-c C-p' prints it.
  930.  
  931.    Thus in four simple of keystrokes, after reading the abstract in the
  932. mail, the paper is in the printer bin. This could even be reduced to a
  933. mouse click and the print command.
  934.  
  935. Example:  TeX File with Appended "PostScript"
  936. =============================================
  937.  
  938.    Reading a reference to the paper "hep-lat/9212017" we type:
  939.      M-x get-paper-from-data
  940.  
  941.    the *Atavachron* asks:
  942.      >>>   Local name for paper? [.tex appended] (9212017):
  943.  
  944.    We hit `[RETURN]' to accept the default name `9212017' and the paper
  945. is retrieved. We are notified of appended "PostScript" figures
  946.      >>>   Looks like there are appended PostScript figures...
  947.  
  948.    then asked by the *Atavachron*
  949.      >>>   Shall I surgically remove the figures? (y or n)
  950.  
  951.    Entering `y' gets the reply "`Entering slice and dice mode...'".
  952. First a backup is made called `9212017.tpl'. Then, upon demarking the
  953. first figure, the *Atavachron* asks
  954.      >>>   Name for figure file below this point? (bumpy-operator.ps):
  955.  
  956.    Hitting `[RETURN]' accepts the default name `bumpy-operator.ps'
  957. which was found in the nearby comments. The "PostScript" figure
  958. `bumpy-operator.ps' is extracted; this process is repeated four times
  959. extracting each of the four appended figures. On the last figure the
  960. *Atavachron* asks:
  961.      >>>   Name for figure file below this point? (* NONE FOUND *):
  962.  
  963.    Note the `* NONE FOUND *'; this is because of a typing error in the
  964. original paper file where the figure is labeled "binning-error.p", and
  965. the ".ps" search fails. In this case `binning-error.ps' (or some other
  966. name) *must* be entered at the above prompt by hand.
  967.  
  968.    "Slice and dice" mode is now complete and the TeX portion of the
  969. original paper is returned, ready for `tex-mode' processing. In
  970. addition, a report of the figure extraction is made in the file
  971. `9212017.figs':
  972.  
  973.       * -\|/- The Atavachron  (1.1) *
  974.      Below are the PostScript figures extracted from: 9212017.tex
  975.      -----------------------------------------------
  976.      bumpy-operator.ps
  977.      interpolation.ps
  978.      surface-energy.ps
  979.      binning-error.ps
  980.  
  981. Example:  Storing and Processing a Paper (with *uuencoded* Figures)
  982. ===================================================================
  983.  
  984.    While logged in from home, you read the abstract of Distler's paper
  985. "hep-th/9212062". You type:
  986.      M-x store-paper
  987.  
  988.    with the point in the abstract. The *Atavachron* asks the usual:
  989.      >>>   Local name for paper? (9212062):
  990.  
  991.    to which you enter `distler'. Two files are retrieved with the
  992. message: `Use "process-paper" on "distler" at your convenience..."'
  993.  
  994.    The next morning you find the files `distler.1' and `distler.2'
  995. stored in your `atv-download-dir', thus you enter Emacs and do `M-x
  996. process-paper'. The response is
  997.      >>>   Name of stored paper? [without suffix]:
  998.  
  999.    You enter `distler' and the *Atavachron* begins to process the
  1000. paper. Since there are multiple files to this paper, the *Atavachron*
  1001. checks for *uuencoded* figures. Finding them, it unpacks the figures
  1002. into the `atv-uufiles-dir' where TeX and `dvips' can get at them.
  1003. Finally it returns the TeX file of the paper in `tex-mode' and a
  1004. manifest `distler2.rpt' of the uudecoding:
  1005.  
  1006.       * -\|/- The Atavachron  (1.1) *
  1007.      This is the output of: sh hep-th/9212062.2
  1008.      Below should be a manifest of the enclosed files:
  1009.      ------------------------------------------------
  1010.      x grapha.eps, 3080 bytes, 7 media blocks.
  1011.      x graphb.eps, 3080 bytes, 7 media blocks.
  1012.      x fig.pro, 3089 bytes, 7 media blocks.
  1013.  
  1014. 
  1015. File: atavachron.info,  Node: Things To Come,  Next: Index,  Prev: Example Sessions,  Up: Top
  1016.  
  1017. Things To Come
  1018. **************
  1019.  
  1020.    * The first thing that should be done is clean the code a bit. *The
  1021.      Atavachron* grew out of a 20 line `(defun get-paper ())' to teach
  1022.      myself some Lisp, into the present package by Lamarkian evolution.
  1023.      Certainly there are more efficient forms of various functions, and
  1024.      many of the large modules could be broken down into reasonable
  1025.      blocks.  Along these lines is a redefinition of the package as a
  1026.      "semi-major mode" of some kind, instead of a non-linear collection
  1027.      of functions.
  1028.  
  1029.    * Improved error trapping; as `atavachron-mail' comes in, these will
  1030.      be fixed. At present *The Atavachron* will crash if you don't give
  1031.      an expected response, say `[RETURN]' when it really needs a string
  1032.      input, however these seem to just abort without fatalities.
  1033.  
  1034.    * At present the macro directories at the archives are ignored,
  1035.      meaning you have to get macros via the usual routes of mail or
  1036.      ftp.  A nice feature would be macro (ie. `\input' and
  1037.      `\document{}') checking, by which *The Atavachron* would search
  1038.      the gotten [La]TeX file for all auxillary files and macro packages
  1039.      needed, check the path for these, then report and get the missing
  1040.      macros.
  1041.  
  1042.    * Finally, more consistent [La]TeX in preprint submissions will make
  1043.      possible the assumption that the preprint will actually pass the
  1044.      texxing stage, thereby making auto-previewing (at the click of the
  1045.      mouse on an abstract), and similar futuristic fantasies possible.
  1046.      This should be provided soon, along with auto-printing, as hook
  1047.      functions for `atv-auto-tex-command' which sense the exit of the
  1048.      TeX shell, and determine if it is safe to send the results to the
  1049.      printer.
  1050.  
  1051. 
  1052. File: atavachron.info,  Node: Index,  Prev: Things To Come,  Up: Top
  1053.  
  1054. Concept Index
  1055. *************
  1056.  
  1057. * Menu:
  1058.  
  1059. * atavachron.el:                        Top.
  1060. * atavachron-mail:                      Utilities.
  1061. * atv-download-dir:                     atv-download-dir.
  1062. * atv-interesting-file:                 atv-interesting-file.
  1063. * atv-main-ftp-site:                    atv-main-ftp-site.
  1064. * atv-no-csh:                           atv-no-csh.
  1065. * atv-prompt-filename:                  atv-prompt-filename.
  1066. * atv-uufiles-dir:                      atv-uufiles-dir.
  1067. * buffer-menu:                          Processing Functions.
  1068. * dvips:                                atv-uufiles-dir.
  1069. * get-abstract-from-data:               Title Listings and Abstracts.
  1070. * get-abstract:                         Title Listings and Abstracts.
  1071. * get-listing-from-data:                Title Listings and Abstracts.
  1072. * get-paper-from-data:                  Getting Papers.
  1073. * get-paper:                            Getting Papers.
  1074. * insert-buffer:                        Processing Functions.
  1075. * interesting:                          Utilities.
  1076. * process-paper:                        Processing Functions.
  1077. * shell-paper:                          Processing Functions.
  1078. * slice-and-dice:                       Processing Functions.
  1079. * store-listing-from-data:              Title Listings and Abstracts.
  1080. * store-paper-from-data:                Storing Papers.
  1081. * store-paper:                          Storing Papers.
  1082. * Appended PostScript:                  Paper Formats.
  1083. * Appended PostScript: Example:         Example Sessions.
  1084. * archive.cis.ohio-state.edu:.../ange-ftp: ange-ftp.el.
  1085. * Atavachron:                           General Description.
  1086. * atv-auto-tex-paper:                   atv-auto-tex-paper.
  1087. * Author's Address:                     General Description.
  1088. * Auto-Previewing:                      Things To Come.
  1089. * Auto-Previewing:                      atv-auto-tex-paper.
  1090. * Bakker, Bas <bas@phys.uva.nl>:        General Description.
  1091. * Bulletin Board Software:              General Description.
  1092. * Configuration:                        Configuration.
  1093. * Emacs Variables:                      Configuration.
  1094. * Example .emacs File:                  Example .emacs File.
  1095. * Example Sessions:                     Example Sessions.
  1096. * Files Made by Macro uufiles:          Paper Formats.
  1097. * Free Software Foundation:             Copying Conditions.
  1098. * Functions:                            Functions.
  1099. * General Description:                  General Description.
  1100. * Getting Papers:                       Getting Papers.
  1101. * Ginsparg, Paul <ginsparg@qfwfq.lanl.gov>: General Description.
  1102. * GNU Emacs editor:                     Top.
  1103. * GNU General Public License:           Copying Conditions.
  1104. * Gough, Graham:                        zcat.el.
  1105. * James Hetrick <hetrick@phys.uva.nl>:  Top.
  1106. * Kilcup, Greg <kilcup@pacific.mps.ohio-state.edu>: General Description.
  1107. * Loading atavachron.el:                Example .emacs File.
  1108. * Local Branch Directories:             atv-download-dir.
  1109. * Marcus Speh <marcus@x4u.desy.de>:     Top.
  1110. * Mini-buffer:                          General Description.
  1111. * Modem File Transfer:                  Storing Papers.
  1112. * Multiple Files:                       Paper Formats.
  1113. * Non-Integer Extensions:               Paper Formats.
  1114. * Norman, Andy:                         ange-ftp.el.
  1115. * Obtaining the *Atavachron* Package:   Copying Conditions.
  1116. * Paper Formats:                        Paper Formats.
  1117. * Paper in Multiple Files:              Processing Functions.
  1118. * Primary File:                         Paper Formats.
  1119. * Primary File:                         atv-auto-tex-paper.
  1120. * Processing Functions:                 Processing Functions.
  1121. * Processing Paper: Example:            Example Sessions.
  1122. * Reading abstracts in Mail:            Getting Papers.
  1123. * Several Buffers:                      Processing Functions.
  1124. * Shell Scripts:                        Paper Formats.
  1125. * Since TeX file:                       Paper Formats.
  1126. * Single TeX file: Example:             Example Sessions.
  1127. * Speh, Marcus <marcus@x4u.desy.de>:    General Description.
  1128. * Star Trek:                            General Description.
  1129. * Storing Paper: Example:               Example Sessions.
  1130. * Storing Papers:                       Storing Papers.
  1131. * Supported Archives:                   General Description.
  1132. * Tar Files:                            Paper Formats.
  1133. * Texinfo:                              General Description.
  1134. * TEXINPUTS Environment Variable:       atv-download-dir.
  1135. * Things to Come:                       Things To Come.
  1136. * Title Listings and Abstracts:         Title Listings and Abstracts.
  1137. * Utilities:                            Utilities.
  1138. * UUfiles:                              Paper Formats.
  1139. * UUfiles:                              Paper Formats.
  1140. * UUfiles: Example:                     Example Sessions.
  1141. * Wish List:                            Things To Come.
  1142.  
  1143.  
  1144. 
  1145. Tag Table:
  1146. Node: Top100
  1147. Node: Copying Conditions1231
  1148. Node: General Description2866
  1149. Node: Configuration7736
  1150. Node: Example .emacs File8807
  1151. Node: atv-main-ftp-site10984
  1152. Node: atv-download-dir11756
  1153. Node: atv-uufiles-dir13365
  1154. Node: atv-prompt-filename13944
  1155. Node: atv-interesting-file14628
  1156. Node: atv-auto-tex-paper15370
  1157. Node: atv-no-csh16756
  1158. Node: Batteries Not Included17472
  1159. Node: ange-ftp.el18136
  1160. Node: zcat.el18735
  1161. Node: .netrc19184
  1162. Node: .dvipsrc20326
  1163. Node: Functions21480
  1164. Node: Getting Papers22008
  1165. Node: Storing Papers24087
  1166. Node: Processing Functions24776
  1167. Node: Title Listings and Abstracts28135
  1168. Node: Utilities29313
  1169. Node: Paper Formats30529
  1170. Node: Example Sessions35148
  1171. Node: Things To Come39842
  1172. Node: Index41698
  1173. 
  1174. End Tag Table
  1175.