==============================================================================
#            README for debian-reference (Version 2 series)                  #
#                     Fri Jun  5 16:37:09 UTC 2009                           #
#                    Osamu Aoki, osamu at debian dot org                     #
==============================================================================

Thank you installing debian-reference (DR).

This family of documentation packages have their contents in:

  /usr/share/doc/debian-reference-common/README.gz        (this file)
  /usr/share/doc/debian-reference-common/html/index.html  (index file)
  /usr/share/doc/debian-reference-common/html/*           (contents)
  /usr/share/pixmaps/debian-reference.png                 (icon)
  /usr/share/debian-reference/debian-reference    (this starts browser)

== SOURCE ==

First I recommend you to download the source package to inspect it.
 $ apt-get source debian-reference

Latest SVN repository contents can be inspected/cloned as:
 $ svn co svn://svn.debian.org/svn/ddp/manuals/trunk manuals     # SVN     (ro)
 $ svn co svn+ssh://svn.debian.org/svn/ddp/manuals/trunk manuals # SVN+SSH (r/w)
 http://svn.debian.org/wsvn/ddp/manuals/trunk
 http://www-master.debian.org/build-logs/ddp/                  DDP build results

Older lenny GIT repository contents can be inspected/cloned as:
 $ sensible-browser http://git.debian.org/?p=users/osamu/debian-reference.git              # web
 $ git clone  ssh://git.debian.org/~osamu/public_git/debian-reference.git debian-reference # r/w
 $ git clone  ssh://git.debian.org/git/users/osamu/debian-reference.git   debian-reference # r/w
 $ git clone  git://git.debian.org/~osamu/debian-reference.git            debian-reference # ro
 $ git clone  git://git.debian.org/git/users/osamu/debian-reference.git   debian-reference # ro
 $ git clone http://git.debian.org/git/users/osamu/debian-reference.git   debian-reference # ro

 * For lenny, English document was rewritten completely using moinmoin.
 * For squeeze, the source is now converted to new build structure using
   asciidoc.
 * Translated documents will be using po4a infrastructure.
 * For http://www.debian.org/ web site publishing, XML files are used to build
   pages.  So before commiting, you should commit generated XML to SVN.

This source is maintained in alioth ddp SVN repository now.

== BUGS ==

If you find any issues or shortcomings of this DR, please file bug reports
using reportbug command against "debian-reference" package.  See also,
http://bugs.debian.org for how Debian BTS works.

For bug report, it is strongly recommended to write what you want as
alternative.  "It does not work...", "I can do this...", etc. are not so
useful.  "This section should be rewritten as ...." is what is needed.

For simple grammer errors and spell errors, diff against plain text file or
the source file are most appreciated.

== TODO ==

* Close CVS at SF.NET
* Refine po4a build infrastructure

Osamu

# vim: set tw=78 sts=2 ai expandtab:
