home *** CD-ROM | disk | FTP | other *** search
/ Dream 57 / Amiga_Dream_57.iso / Linux / Bureautique / lyx.txt < prev    next >
Text File  |  1998-10-02  |  9KB  |  246 lines
  1. This is a LyX 1.0.x release
  2. ---------------------------
  3.  
  4. What is LyX?
  5.  
  6.     LyX is a modern approach of writing documents with a computer
  7.     which breaks with the tradition of the obsolete typewriter
  8.     concept.  It is designed for people who want a professional
  9.     output with a minimum of time effort, without becoming specia-
  10.     lists in typesetting.  Compared to common word processors LyX
  11.     will increase the productivity a lot, since most of the type-
  12.     setting will be done by the computer, not the author.  With LyX
  13.     the author can concentrate on the contents of his writing,
  14.     since the computer will take care of the look.
  15.  
  16.     You can read more about this concept in the documentation,
  17.     which you'll find under the Help menu.  If you plan to use LyX, 
  18.     you actually should read about it to be able to make the best of 
  19.     it.
  20.  
  21. What is LyX not?
  22.  
  23.     LyX is not just another word processor that claims to be a
  24.     Desktop Publishing program.  It's a more modern way of
  25.     creating documents that look much nicer, but without wasting 
  26.     time with layout-fiddling.  For these reasons you might need 
  27.     little time to get used to the differences.
  28.     If you are looking for a free Desktop Publishing program for
  29.     Unix, you will be disappointed.
  30.  
  31. What do I need to run LyX?
  32.  
  33.     A Unix-like system or OS/2 with XFree
  34.     At least X11 Release 5
  35.     A decent LaTeX2e installation (e.g. teTeX or NTeX)
  36.     Optionally ghostscript and ghostview (or compatible)
  37.  
  38. What's new?
  39.  
  40.     Read WHATSNEW.
  41.  
  42. How do I install a binary distribution of LyX?
  43.  
  44.     Unpack it and run it.  We recommend to unpack it in /usr/local,
  45.     but it should work anywhere.  In particular, you can try LyX
  46.     in a temporary directory before installing permanently by
  47.     typing "bin/lyx".
  48.  
  49.     We recommend that you configure LyX system wide by reading and
  50.     modifying the "lib/lyxrc" file, usually found as the file
  51.     "/usr/local/share/lyx/lyxrc".
  52.  
  53.     User-level configuration is possible with a file "~/.lyx/lyxrc".
  54.     You can use the system wide file "lib/lyxrc" as a template for your
  55.     personal lyxrc file.  Remember that a personal configuration file
  56.     will be used instead of any system wide file.
  57.  
  58.     If this is a binary release, you should read the notes regarding
  59.     this particular build in README.bin.
  60.  
  61. How do I upgrade from an earlier LyX version?
  62.  
  63.     Read the file UPGRADING for info on this subject.
  64.     If you upgrade from version 0.12.0, you don't need to do anything
  65.     special.
  66.  
  67. What do I need to compile LyX?
  68.  
  69.     This section only applies for people using the source distribution.
  70.  
  71.     1. A good c++ compiler.  Development is being done mainly on
  72.        gcc/g++, but many others work.
  73.     2. The Xforms library version 0.81, 0.86 or 0.88. It is available
  74.        from
  75.             http://bloch.phys.uwm.edu/xforms
  76.             ftp://einstein.phys.uwm.edu/pub/xforms/
  77.        It is available (free) only in binary format, source code is
  78.        not available.  If it is not available for your machine,
  79.        contact the Xforms developers to request a version for
  80.        your system.
  81.     3. LibXpm version 4.7 (or newer).  Older libXpm versions are
  82.        incompatible with the current Xforms library. You can find
  83.        libXpm at this link:
  84.         http://www.funet.fi/pub/Linux/sunsite/X11/libs/!INDEX.html
  85.  
  86.     Read the file "INSTALL" for more information on compiling.
  87.  
  88. Okay, I've installed LyX. What now?
  89.  
  90.     Once you've installed it, and everything looks fine, go read
  91.     the "Introduction" item under the Help menu.  After that, you 
  92.     should also read "Help/LaTeX configuration" which provides info 
  93.     on your LaTeX configuration as LyX sees it.  You might miss a package
  94.     or two that you'd like to have.
  95.  
  96. There is a mailing list intended for users:
  97.  
  98.     Use this list if you have questions on how to get LyX working,
  99.     how to use LyX and other question related to usage. You can
  100.     also check the FAQ, see below.
  101.  
  102.     To subscribe send mail to 
  103.  
  104.         lyx-users-request@kde.org
  105.  
  106.     with "subscribe" as the subject.
  107.     
  108.     To contribute to the mailing list, mail to
  109.  
  110.         lyx-users@kde.org
  111.  
  112.     Please send unsubscription messages to lyx-users-request only!
  113.  
  114.     This mailing list is mirrored and archived on the Web at
  115.  
  116.         http://bioclox.bot.biologie.uni-tuebingen.de/
  117.                 mailing-archive/lyxlist/maillist.html
  118.  
  119.     courtesy of Dirk Engelmann.
  120.  
  121. There is also a mailing list for developers available:
  122.  
  123.     This list is intended only for the discussion of subjects
  124.     relevant to the implementation, planning, hacking and
  125.     improvement of LyX.
  126.  
  127.     To subscribe send mail to 
  128.  
  129.         majordomo@via.ecp.fr
  130.  
  131.     with in *BODY*:
  132.  
  133.         subscribe lyx
  134.         end
  135.  
  136.     To contribute to the mailing list, mail to
  137.  
  138.         lyx@lyx.org
  139.  
  140.     Please send unsubscription messages to majordomo@via.ecp.fr only!
  141.  
  142.     This mailing list is mirrored and archived on the Web at
  143.  
  144.             http://www.via.ecp.fr/~andre/lyx/archive/
  145.  
  146. Other Internet resources of relevance to LyX
  147.  
  148.     Main LyX archive site:
  149.     ftp://ftp.lyx.org/pub/lyx/
  150.  
  151.     The LyX homepage contains valuable information, including links
  152.     to other LyX homepages around the world:
  153.     http://www.lyx.org/
  154.  
  155.     Other LyX archive sites are available at:
  156.     ftp://fiwi02.wiwi.uni-tuebingen.de/pub/LyX/
  157.     ftp://ftp.ibp.fr/pub/lyx/
  158.     ftp://ftp.sdsc.edu/pub/other/lyx/
  159.     ftp://ftp.fciencias.unam.mx/pub/Lyx/
  160.     ftp://mirror.aarnet.edu.au/pub/LyX/
  161.  
  162.     The latest development source can be found at:
  163.     http://www.devel.lyx.org/
  164.     ftp://www.devel.lyx.org/pub/lyx/
  165.  
  166.     The user's mailing list is archived at:
  167.     http://bioclox.bot.biologie.uni-tuebingen.de/
  168.             mailing-archive/lyxlist/maillist.html
  169.  
  170.     The developer's mailing list is archived at:
  171.         http://www.via.ecp.fr/~andre/lyx/archive/
  172.  
  173. How is the numbering scheme for releases? Like the Linux kernel?
  174.  
  175.     Yes, it's like the Linux kernel since LyX version 0.8:
  176.  
  177.         0.10.x, 0.12.x, 1.0.x    ... are stable, public releases
  178.         0.11.x, 0.13.x, 1.1.x    ... are developer releases
  179.  
  180.     Of course you may also use the developer releases, but only
  181.     at your own risk. This is definitely higher than your risk when 
  182.     using the public releases, even if this is your own risk, too.
  183.  
  184.     LyX has been put under cvs control.  See http://www.devel.lyx.org
  185.     for more information about how to get the latest sources.
  186.  
  187. How do I submit a bug report?
  188.  
  189.     If possible, read the "Known Bugs" document found under the
  190.     Help menu.  You'll find detailed info on submitting bug reports
  191.     there.
  192.  
  193.     You should also check the BUGS file in this directory.
  194.  
  195.     If you can't do that, send details to lyx@lyx.org.  Don't forget
  196.     to mention which version you are having problems with!
  197.  
  198. How do I prepare a binary distribution for the use of others?
  199.  
  200.     1) Compile LyX with the right compiler switches for your
  201.     architecture. In particular you might want to ensure that libraries
  202.     like xforms and xpm are statically linked. To this end, you
  203.     can use a command like
  204.  
  205.         make LYX_LIBS='/foo/libforms.a /bar/libXpm.a'
  206.  
  207.     Moreover, make sure you use the --without-latex-config switch
  208.     of configure, since others might not be interested by your
  209.     configuration :-) 
  210.  
  211.     2) Create a file README.bin describing your distribution and
  212.     referring to *you* if problems arise. As a model, you can use the 
  213.     file development/tools/README.bin.example which was originally
  214.     written for Linux by David L. Johnson. Do *not* use directly
  215.     the file in the distribution, since it refers to Linux and
  216.     points to David L. Johnson for help. However, it can be a good
  217.     starting point. Note that removing the file completely is
  218.     better than not    editing it at all.
  219.  
  220.     3) Type `make bindist'. This will create a file
  221.     lyx-0.xx.yy-bin.tar.gz. Rename it to reflect you architecture 
  222.     and the peculiarities of your build (e.g. static vs. dynamic).
  223.  
  224.     4) Check that everything is correct by unpacking the distribution 
  225.     in some private place and running it. In particular, check the 
  226.     output of `ldd lyx' to know which libraries are really needed.
  227.  
  228.     5) Upload your binary file to ftp.via.ecp.fr:/pub/lyx/uploads.
  229.  
  230. How can I participate in the development of LyX? 
  231.  
  232.     Any help with the development of LyX is greatly appreciated--
  233.     after all LyX wouldn't be what it is today without the help
  234.     of volunteers. We need your help!
  235.  
  236.     If you want to work on LyX, you should contact the developer's 
  237.     mailing list for discussion on how to do your stuff.  LyX is being 
  238.     cleaned up, and therefor it's important to follow some rules. 
  239.     Read about those rules in development/Code_rules/.
  240.  
  241. Thank you for trying LyX, and we appreciate your feedback in the mailing
  242. lists.
  243.  
  244. The LyX Team.
  245. (lyx@via.ecp.fr)
  246.