On Friday 27 November 2009 23:47:53, Freddy Vulto wrote:
> Ville Skyttä <ville.skytta <at> iki.fi> writes:
> > I'm not sure if I've asked this before, but why do we have the generated
> > HTML doc in git, and why is it in a such an oddly named dir ("html~")?
>
> I think my idea was to show us (developers) the output of generated HTML
> documentation, especially those not being able to run asciidoc. I used
> the tilde (~) in html~ to give a hint that the contents of this
> directory are automatically generated and manual changes here will be
> overwritten.
>
> Drawback of this approach is the unnecessary space the HTML
> documentation is taken in git. Another drawback is that documentation
> commits go unnoticed on the commit-mailing-list because they easily
> exceed the auto-mail-on-commit size limit (was it 200K?), and on the
> other hand are causing too much noise.
>
> Since asciidoc source documentation is very readable after all, +1 to
> remove the `doc/html~' dir from git.Err, I already removed it a couple of days ago without waiting for consensus, sorry :) > Maybe we can program an auto-upload of generated HTML documentation to > the bash-completion website after modifications to asciidoc source files > (doc/*)? I can do that, if you agree. Kindly, David -- . ''`. Debian developer | http://wiki.debian.org/DavidPaleino : :' : Linuxer #334216 --|-- http://www.hanskalabs.net/ `. `'` GPG: 1392B174 ----|---- http://snipr.com/qa_page `- 2BAB C625 4E66 E7B8 450A C3E1 E6AA 9017 1392 B174
signature.asc
Description: This is a digitally signed message part.
_______________________________________________ Bash-completion-devel mailing list [email protected] http://lists.alioth.debian.org/mailman/listinfo/bash-completion-devel
