web-based docs, and what to do with Samba3-HOWTO
Karolin Seeger
kseeger at sambaxp.org
Tue May 21 02:22:51 MDT 2013
On Tue, May 21, 2013 at 06:09:46PM +1000, Andrew Bartlett wrote:
> On Tue, 2013-05-21 at 08:44 +0200, Karolin Seeger wrote:
> > Hi,
> >
> > On Sat, May 18, 2013 at 10:58:16AM +0200, Luk Claes wrote:
> > > On 05/18/2013 10:41 AM, Andrew Bartlett wrote:
> > > > On Sat, 2013-05-18 at 10:30 +0200, Luk Claes wrote:
> > > >> On 05/17/2013 11:56 PM, Andrew Bartlett wrote:
> > > >>> On Fri, 2013-05-17 at 15:19 +0200, Luk Claes wrote:
> > > >> If one changes the documentation it's easier to test them when one is
> > > >> able to regenerate just the documentation than to start a build of
> > > >> everything.
> > > >
> > > > Sure, but after you build everything once, it won't rebuild anything
> > > > that hasn't changed after that.
> > >
> > > make clean in the docs-xml directory can take care of this.
> > >
> > > >> Is there a reason the html is still in the release in that case?
> > > >
> > > > I can't find any html files (other than SWAT) in our release, or
> > > > generated and installed by our build process. Can you clarify what you
> > > > refer to here?
> > >
> > > Oh, I did not have a look at what was specifically included. If it's
> > > only SWAT documentation then it's fine as it is.
> >
> > I think that I mentioned that the html man pages need to be created by the
> > waf build, because I need them for the web site. When the docs-xml build
> > will be removed, I need to be able to build them with waf or we don't put
> > them on the web site any longer (but many people use it).
>
> I agree the web-based manpages are useful, particularly for smb.conf,
> and doubly because we have ditched SWAT. What other docs do you
> currently push?
Curently, I am updating the html man pages only.
>Is the Samba3-HOWTO on the web also updated, and given
> the outdated content therein, should we still be publishing it? Is out
> of date documentation better or worse than nothing?
No, I don't update this the Samba3-HOWTO. From my point of view, it's better to
remove outdated documentation at some point, but I think John should comment on
this one.
Cheers,
Karolin
--
Samba http://www.samba.org
SerNet http://www.sernet.de
sambaXP http://www.sambaxp.org
More information about the samba-technical
mailing list