[PATCH] s4/waf: Add '--no-manpages' option
kamenim at samba.org
Fri Jun 18 06:09:32 MDT 2010
On Fri, Jun 18, 2010 at 14:47, Jelmer Vernooij <jelmer at samba.org> wrote:
> On Fri, 2010-06-18 at 14:23 +0300, Kamen Mazdrashki wrote:
> > On Fri, Jun 18, 2010 at 11:04, Stefan (metze) Metzmacher
> > <metze at samba.org> wrote:
> > Yes, I also don't like the 2nd patch. Developers should notice
> > if the
> > generation
> > of manpages is broken.
> > I don't have the impression most of the developers care about man
> > pages generation,
> > perhaps it is a wrong impression though :)
> Even if they don't view the manpages it's important for them to notice
> when they break.
I just can't image how can one break man pages while writing C/Python code?
On the other hand, I am changing something in man pages, then I would be
using plain configure as this is the way the release will be build right?
> > If modified the first patch a bit, see
> > And also skip the generation of pidl manpages with
> > --no-manpages.
> > What do you thing about this one:
> > > Rather, if you'd want to not have to specify this flag we
> > should detect
> > > if the user has the stylesheets installed locally and only
> > prohibit
> > > generating them if they don't have them.
> > Yes, the usage of --nonet would be really good as a default,
> > together with a test that checks if we can generate a trivial
> > manpage
> > when using the --nonet option.
> > Such an option would be my favorite :)
> > (I recall that stand alone build for talloc also wants style sheets
> > from the net, right?)
> talloc (like Samba) only uses stylesheets from the net if you don't have
> them installed locally.
> Is there a particular reason you can't install docbook-xsl ? With that
> package installed it takes less than 10 seconds to generate the manpages
Yes. I've been very annoyed when it took me 30 mins to make a build few days
By this time, I used to spent 5-7min on this, so I was quite surprised when
my build went so long for no particular reason.
Then I had some hard time to find out that I need docbook-xsl
(thanks to abartlet for pointing me at the right thread in samba-technical).
I guess there are a lot of people like me, that are working on small parts
and all the sudden, they have to wait for so long to have a clean build,
Another use case for this -> I am developing/testing on machines that are
online all the time. So when I had to rebuild samba, I hadn't been able to
In this particular case, I don't even have a work-around :)
For the latter case I like pretty much Metze's idea for '--nonet' switch to
any attempts to access network during samba build.
I hope I made my point clear - it is just more usability for developers :)
kamen.mazdrashki at postpath.com
CISCO SYSTEMS BULGARIA EOOD
More information about the samba-technical