Directory macros/plain/contrib/plipsum

P-LIPSUM
========

'Lorem ipsum' paragraphs generator for the purposes
of the plain TeX developers.

Author: Sergio Spina <sergio.am.spina@gmail.com>

Version: 4.3 of 2013.05.08


Contents of the package
-----------------------

-   `plipsum.nw`: the source file
-   `plipsum.tex`: the format
-   `pliptest.tex`: an example file
-   `plipsum-doc.pdf`: the documentation
-   `compile.sh`: the installation program
-   `stripc`: a python filter
-   `README.md`: this file


Installation
------------

-   Run `plipsum.nw` through noweb. You van find it on the Norman Ramsey
    web page (<http://www.cs.tufts.edu/~nr/noweb/>) or on CTAN
    (<http://www.ctan.org/tex-archive/web/noweb>).
  
    A suitable command can be:

        $ notangle -Rplipsum.tex plipsum.nw | ./stripc > plipsum.tex

    `stripc` is a python filter that strips away comments and blank spaces
    from the final file.

-   Move the resulting `.tex` file to a place where TeX finds it.	
    On a TDS compliant system this should be (substitute `$TEXMF` 
    with your local or home texmf directory):

        $TEXMF/tex/plain/plipsum/

-   If you like to, move the source file (`.nw`) in a
    source directory of your system.

-   Update your filename database. How to achieve this depends 
    on your system. For TeXlive one of these commands should work:

        $ texhash ~/texmf
        $ sudo mktexlsr ~/texmf
  
    More info on this is available with:
  
        $ texhash --help
        $ sudo mktexlsr --help
  
-   If you are using a non TDS compliant system you are on your own; take a
    look in the documentation how to install new packages.

-   If you are using windows (TM) you are on your own even more.


License
-------
This material is subject to the LaTeX Project Public License. See
 
        http://www.ctan.org/tex-archive/help/Catalogue/licenses.lppl.html 

for the details of that license. 


Enjoy plipsum. Happy TeXing.


= END =