Bazaar Developer Guide (Proposed)

[Martin Pool]

On 4/13/07, John Arbash Meinel <john at arbash-meinel.com> wrote:
> And have that properly formatted for both HTML and for the Wiki.
>
> Another possibility is to build the images separately and use:
>
> .. image:: foo.png
>
> Though I've used
>
> .. image:: attachment:foo.png
>
> Which actually works well for wiki images (see
> http://bazaar-vcs.org/Performance/0.15)
>
> However, we still have a mismatch between "attachment:foo.png" on the
> wiki and "foo.png" for the disk form.
>
> Anyone have ideas about how to resolve this?
>
> John
> =:->
>
> PS> The Makefile could certainly add:
>
> dot_files := $(wildcard $(addsuffix /*.dot, $(doc_dir)))
> png_files := $(patsubst %.dot, %.png, $(dot_files))
> doc/%.png: doc/%.dot
>   dot -Tpng -o $*.png $*.dot

I think we can just add those Makefile rules and also check in the
output to bzr.dev.  It's nice that ReST lets us use the same source on
the wiki, but if we just keep the definitive form in bzr and put up
the generated html we don't need to rely on moin rendering for these
documents.

-- 
Martin