perl-docs-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject cvs commit: modperl-docs/src/download docs.pod config.cfg
Date Fri, 26 Apr 2002 17:56:49 GMT
stas        02/04/26 10:56:49

  Modified:    src/help help_with_site.pod
               src/download config.cfg
  Added:       src/download docs.pod
  add the documentation download information. and adjust other docs to point
  Submitted by:	Per Einar Ellefsen <>
  Revision  Changes    Path
  1.5       +4 -9      modperl-docs/src/help/help_with_site.pod
  Index: help_with_site.pod
  RCS file: /home/cvs/modperl-docs/src/help/help_with_site.pod,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- help_with_site.pod	21 Apr 2002 17:53:46 -0000	1.4
  +++ help_with_site.pod	26 Apr 2002 17:56:49 -0000	1.5
  @@ -60,8 +60,8 @@
   thing. But, for example, the guide alone takes 735 pages in PDF
   format, so you might be overwhelmed by the size of the files if you're
   downloading them each time from the net. In that case, we suggest that
  -you L<download|/How_this_site_was_created> the sources, build the
  -documentaion and read it off your hard disk.
  +you L<download|download::docs> the sources, build the documentaion and
  +read it off your hard disk.
   Another idea to make it load faster is to adjust your browser's
   caching. By caching the pages, you might not have to download them
  @@ -86,13 +86,8 @@
   files, using Perl DocSet Framework, which in turn is based on Template
  -If you are interested in downloading the site sources, you can get them from CVS:
  -  % cvs -d "" login
  -password: "anoncvs".
  -  % cvs -d "" co modperl-docs
  +If you are interested in downloading the site sources, please see the
  +L<relevant section|download::docs>.
   META: add the URL of the DocSet when it gets released.
  1.5       +2 -1      modperl-docs/src/download/config.cfg
  Index: config.cfg
  RCS file: /home/cvs/modperl-docs/src/download/config.cfg,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- config.cfg	16 Apr 2002 05:15:55 -0000	1.4
  +++ config.cfg	26 Apr 2002 17:56:49 -0000	1.5
  @@ -5,7 +5,7 @@
       title => "Download",
       abstract => <<EOB,
  -Get source and binary mod_perl distributions and additional Perl modules
  +Get source and binary mod_perl distributions and download the documentation
       # an ordered list pod files relative to $c{src}
  @@ -14,6 +14,7 @@
  +        docs.pod
       # non-pod/html files or dirs to be copied unmodified
  1.1                  modperl-docs/src/download/docs.pod
  Index: docs.pod
  =head1 NAME
  =head1 Description
  You may want to download and install the mod_perl documentation
  locally for easier reading.
  To install the documentation you will have to install the whole site
  at the same time though, but this should just be a benefit because you
  can mirror the whole site locally and have access to all the
  information available here.
  =head1 Download
  The mod_perl documentation lives in the C<> CVS
  server. To get it, you will need to checkout a copy. Assuming you have
  CVS installed, run the following commands from the directory you want
  to place the I<modperl-docs> directory in:
    % cvs login
      (use the password "anoncvs")
    % cvs co modperl-docs
  You will now find a directory called I<modperl-docs> in the current
  working directory which contains all the sources needed to build the
  =head1 Build
  =head2 Normal build process
  The programs used to build the site are included in the directory you
  checked out from CVS. To build the whole site, run this while being
  placed in the I<modperl-docs> directory.
    % bin/build
  This will place the site in the sub-directory I<dst_html>. You may
  open I<index.html> in there to start browsing the site.
  =head2 PDF version
  =head3 Prerequisites
  To build the PDF documents, you will need to have some extra tools
  installed: I<ps2pdf> (which should come with the Ghostscript
  distribution, see, and maybe the
  I<netpbm> tools too. For Windows platforms, see the file
  I<INSTALL.win32> for information.
  Please also note that to build the PDF version, you will have to have
  I<html2ps> installed. This tool is distributed with DocSet, the
  framework used to build the site. DocSet is available in the I<lib/>
  directory of the site repository, but you will have to download the
  DocSet distribution to get I<html2ps>: download the latest from , and then install it with the usual:
    % tar -zxvf DocSet-0.xx.tar.gz
    % cd DocSet-0.xx
    % perl Makefile.PL
    % make
    % make test
    % make install
  (replace C<make> with C<nmake> on Windows systems, this implies that
  you have C<nmake> installed, see the ActivePerl docs for this:
  =head3 Building
  Now, you can go back to your I<modperl-docs> directory. Building the
  PDF version is as easy as with the HTML version, just do a simple:
    % bin/build -d
  And the PDF version will be built. This is often very time-consuming
  and heave on resources though. The results will be placed in
  I<dst_html> too, with links on the HTML pages to the PDF versions. A
  I<dst_ps> directory is also created, which contains intermediate HTML,
  PostScript and PDF files.
  =head1 Keeping your local copy up to date
  Now that you have a working copy of the mod_perl site, you will want
  to keep your documentation up to date. It is updated quite frequently,
  so you might want to follow the L<docs-cvs mailing
  list|maillist::list-docs-cvs> to see when changes are made.
  Once you see a change is made, you need to update your CVS working
  copy, and re-build the site (although it will only rebuilt modified
    % cvs up
    % bin/build
  Rebuilding the PDF version is just as easy, just run:
    % bin/build -d
  There are some times however whena  simple rebuild will be enough:
  usually when there are changes made to the design or to I<config.cfg>
  files. In that case, you will need to force the whole rebuild:
    % bin/build -f
    % bin/build -df    # if you want PDF to be rebuild.
  =head1 Maintainers
  Maintainer is the person(s) you should contact with updates,
  corrections and patches.
  =item *
  the L<documentation mailing list|maillist::list-docs-dev>
  =head1 Authors
  =item *
  Per Einar Ellefsen E<lt>per.einar (at) skynet.beE<gt>
  Only the major authors are listed above. For contributors see the
  Changes file.

To unsubscribe, e-mail:
For additional commands, e-mail:

View raw message