ReleaseNotesPreparation [FreeBSD WIKI]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Notes for how to prepare release documentation ======

===== Prerequisites =====

  - Install [[http://svnweb.freebsd.org/ports/head/textproc/docproj/|textproc/docproj]].

  - Checkout svn+ssh:%%//%%svn.freebsd.org/doc/head to ${DOCBASE} (~/doc, for example).

  - Checkout svn+ssh:%%//%%svn.freebsd.org/base/stable/10 to ${SRCBASE} (~/src, for example).

===== Build instructions =====

<code>
% cd ${SRCBASE}/release/doc/en_US_ISO8859-1
% make DOC_PREFIX=${DOCBASE}
</code>

After the above commands, release/doc/* directories will have article.html:

  * errata/article.html
  * hardware/article.html
  * installation/article.html
  * readme/article.html
  * relnotes/article.html

The source files are */article.xml.  Note that the hardware notes is
not a simple XML->HTML translation.  It extract hardware support
information from ${SRCPREFIX}/share/man/man4*/*.  So, just checking
out ${SRCPREFIX}/release/doc does not work.

The resulting HTML files are used in
${DOCBASE}/en_US.ISO8859-1/htdocs/releases/{N.N}R/.  The following
rule is used for the filenames:

  * errata/article.html  ->  errata.html
  * hardware/article.html  -> hardware.html
  * installation/article.html -> installation.html
  * readme/article.html -> readme.html
  * relnotes/article.html -> relnotes-detailed.html

These files are copied and committed for each release.  Do not directly
edit the HTML file.  Update the XML source and build an HTML result
whenever possible.

===== TODO items for 10.0R =====

  - First, please review readme/article.xml, installation/article.xml, and hardware/article.xml first.  These are really outdated and need to be updated.  Edit the source file and check if the build works.  You can commit your change, but please submit it to me if you are not sure of XML syntax.

  - The release notes needs to be trimmed and fixing some old tricks in the stylesheet.  So, I will commit the necessary changes shortly and split the contents and document structure to simplify the updating work for individual items.