Building ubuntu-docs

[Jeremy Bicha]

On 18 April 2012 09:47, Peter Matulis <peter.matulis at canonical.com> wrote:
> How do I build the HTML pages for the documentation contained in
> ubuntu-docs?  I am following the documentation [1] but it does not work.
>  I must be missing something basic, sorry for that.
>
> $ bzr branch lp:ubuntu-docs
> $ cd ubuntu-docs
> $ make all
>
> make: *** No rule to make target `all'.  Stop.
>
> So I saw autogen.sh:
>
> $ ./autogen.sh
> /usr/bin/gnome-autogen.sh
> checking for autoconf >= 2.53...
> .
> .
> .
> config.status: creating Makefile
> config.status: creating ubuntu-help/Makefile
> Now type `make' to compile ubuntu-doc
>
> $ make all
> .
> .
> .
> make[1]: Leaving directory
> `/home/peter/Data/U1/launchpad/ubuntu-docs/ubuntu-help'
> make[1]: Entering directory `/home/peter/Data/U1/launchpad/ubuntu-docs'
> make[1]: Nothing to be done for `all-am'.
> make[1]: Leaving directory `/home/peter/Data/U1/launchpad/ubuntu-docs'
>
> So where are the pages?
>
> $ find . -name '*html'
> ./html
>
> $ ls html
> total 36K
> -rwxrwxr-x 1 peter peter 1.4K Apr 18 09:28 fix-urls.sed*
> drwxrwxr-x 2 peter peter 4.0K Apr 18 09:28 img/
> -rw-rw-r-- 1 peter peter 4.2K Apr 18 09:28 Makefile
> -rw-rw-r-- 1 peter peter  18K Apr 18 09:28 ubuntu.xsl
>
> [1]:
> https://wiki.ubuntu.com/DocumentationTeam/SystemDocumentation/BuildingDocumentation

Ok, try this:

sudo apt-get build-dep ubuntu-docs
bzr branch lp:ubuntu-docs
cd ubuntu-docs
./autogen.sh
make
cd html
make

And your html files should be in html/build. To change the languages
built, look in html/Makefile.

I generally use bzr clean-tree --ignored; bzr clean-tree to reset
things back to how they were before ./autogen.sh, but you may not need
have a need for that.

Jeremy