docs: Building with Makefile

classic Classic list List threaded Threaded
10 messages Options
Reply | Threaded
Open this post in threaded view
|

docs: Building with Makefile

Samba - samba-technical mailing list
On Friday, 5 January 2018 19:56:02 CET Björn Jacke wrote:

> The branch, master has been updated
>        via  3cbeaf4 docs-xml: add basic Makefile dependencies for targets
> that use xsltproc via  9b27948 docs-xml: set a reasonable XML_CATALOG_FILES
> in Makefile via  a2f5b3b docs-xml: generate build/catalog.xml via Makefile
> target from  2245a4b autobuild: fix quoting of --restrict-tests
>
> https://git.samba.org/?p=samba.git;a=shortlog;h=master
>
>
> - Log -----------------------------------------------------------------
> commit 3cbeaf40937082bd7072d715ae02aa0989835432
> Author: Björn Jacke <[hidden email]>
> Date:   Thu Jan 4 16:35:12 2018 +0100
>
>     docs-xml: add basic Makefile dependencies for targets that use xsltproc
>

Why do you build with Makefile? Is the stuff in waf so bad?


        Andreas



Reply | Threaded
Open this post in threaded view
|

Re: docs: Building with Makefile

Samba - samba-technical mailing list
On Fri, Jan 5, 2018 at 12:18 PM, Andreas Schneider via samba-technical
<[hidden email]> wrote:

> On Friday, 5 January 2018 19:56:02 CET Björn Jacke wrote:
>> The branch, master has been updated
>>        via  3cbeaf4 docs-xml: add basic Makefile dependencies for targets
>> that use xsltproc via  9b27948 docs-xml: set a reasonable XML_CATALOG_FILES
>> in Makefile via  a2f5b3b docs-xml: generate build/catalog.xml via Makefile
>> target from  2245a4b autobuild: fix quoting of --restrict-tests
>>
>> https://git.samba.org/?p=samba.git;a=shortlog;h=master
>>
>>
>> - Log -----------------------------------------------------------------
>> commit 3cbeaf40937082bd7072d715ae02aa0989835432
>> Author: Björn Jacke <[hidden email]>
>> Date:   Thu Jan 4 16:35:12 2018 +0100
>>
>>     docs-xml: add basic Makefile dependencies for targets that use xsltproc
>>
>
> Why do you build with Makefile? Is the stuff in waf so bad?

Waf is a heap of shit that invalidates all my other knowledge about
autotools and removes functionality we used to have, like out-of-tree
builds of VFS modules.

--
Regards,
Richard Sharpe
(何以解憂?唯有杜康。--曹操)

Reply | Threaded
Open this post in threaded view
|

Re: docs: Building with Makefile

Samba - samba-technical mailing list
In reply to this post by Samba - samba-technical mailing list
On Fri, 2018-01-05 at 21:18 +0100, Andreas Schneider via samba-
technical wrote:

> On Friday, 5 January 2018 19:56:02 CET Björn Jacke wrote:
> > The branch, master has been updated
> >        via  3cbeaf4 docs-xml: add basic Makefile dependencies for targets
> > that use xsltproc via  9b27948 docs-xml: set a reasonable XML_CATALOG_FILES
> > in Makefile via  a2f5b3b docs-xml: generate build/catalog.xml via Makefile
> > target from  2245a4b autobuild: fix quoting of --restrict-tests
> >
> > https://git.samba.org/?p=samba.git;a=shortlog;h=master
> >
> >
> > - Log -----------------------------------------------------------------
> > commit 3cbeaf40937082bd7072d715ae02aa0989835432
> > Author: Björn Jacke <[hidden email]>
> > Date:   Thu Jan 4 16:35:12 2018 +0100
> >
> >     docs-xml: add basic Makefile dependencies for targets that use xsltproc
> >
>
> Why do you build with Makefile? Is the stuff in waf so bad?

The Makefile build is used for the in-tarball manpages that we ship
because we fear folks won't have xsltproc etc or it won't run for them
(this was an issue for a while on Debian).  

We could remove this step and see if folks really need it, or possibly
do a recursive waf invocation, but for now this is the reason.

Andrew Bartlett

--
Andrew Bartlett                       http://samba.org/~abartlet/
Authentication Developer, Samba Team  http://samba.org
Samba Developer, Catalyst IT          http://catalyst.net.nz/services/samba


Reply | Threaded
Open this post in threaded view
|

Re: docs: Building with Makefile

Samba - samba-technical mailing list
On Sat, 2018-01-06 at 15:53 +1300, Andrew Bartlett via samba-technical
wrote:

> On Fri, 2018-01-05 at 21:18 +0100, Andreas Schneider via samba-
> technical wrote:
> > On Friday, 5 January 2018 19:56:02 CET Björn Jacke wrote:
> > > The branch, master has been updated
> > >        via  3cbeaf4 docs-xml: add basic Makefile dependencies for targets
> > > that use xsltproc via  9b27948 docs-xml: set a reasonable XML_CATALOG_FILES
> > > in Makefile via  a2f5b3b docs-xml: generate build/catalog.xml via Makefile
> > > target from  2245a4b autobuild: fix quoting of --restrict-tests
> > >
> > > https://git.samba.org/?p=samba.git;a=shortlog;h=master
> > >
> > >
> > > - Log -----------------------------------------------------------------
> > > commit 3cbeaf40937082bd7072d715ae02aa0989835432
> > > Author: Björn Jacke <[hidden email]>
> > > Date:   Thu Jan 4 16:35:12 2018 +0100
> > >
> > >     docs-xml: add basic Makefile dependencies for targets that use xsltproc
> > >
> >
> > Why do you build with Makefile? Is the stuff in waf so bad?
>
> The Makefile build is used for the in-tarball manpages that we ship
> because we fear folks won't have xsltproc etc or it won't run for them
> (this was an issue for a while on Debian).  

That is, it is invoked during 'waf dist'.

> We could remove this step and see if folks really need it, or possibly
> do a recursive waf invocation, but for now this is the reason.
>
> Andrew Bartlett
>
--
Andrew Bartlett                       http://samba.org/~abartlet/
Authentication Developer, Samba Team  http://samba.org
Samba Developer, Catalyst IT          http://catalyst.net.nz/services/samba


Reply | Threaded
Open this post in threaded view
|

Re: docs: Building with Makefile

Samba - samba-technical mailing list
In reply to this post by Samba - samba-technical mailing list
On Saturday, 6 January 2018 03:18:11 CET Richard Sharpe via samba-technical
wrote:

> On Fri, Jan 5, 2018 at 12:18 PM, Andreas Schneider via samba-technical
>
> <[hidden email]> wrote:
> > On Friday, 5 January 2018 19:56:02 CET Björn Jacke wrote:
> >> The branch, master has been updated
> >>
> >>        via  3cbeaf4 docs-xml: add basic Makefile dependencies for targets
> >>
> >> that use xsltproc via  9b27948 docs-xml: set a reasonable
> >> XML_CATALOG_FILES
> >> in Makefile via  a2f5b3b docs-xml: generate build/catalog.xml via
> >> Makefile
> >> target from  2245a4b autobuild: fix quoting of --restrict-tests
> >>
> >> https://git.samba.org/?p=samba.git;a=shortlog;h=master
> >>
> >>
> >> - Log -----------------------------------------------------------------
> >> commit 3cbeaf40937082bd7072d715ae02aa0989835432
> >> Author: Björn Jacke <[hidden email]>
> >> Date:   Thu Jan 4 16:35:12 2018 +0100
> >>
> >>     docs-xml: add basic Makefile dependencies for targets that use
> >>     xsltproc
> >
> > Why do you build with Makefile? Is the stuff in waf so bad?
>
> Waf is a heap of shit that invalidates all my other knowledge about
> autotools and removes functionality we used to have, like out-of-tree
> builds of VFS modules.

Hey, I was the one who wanted to use CMake but then someone told me that waf
is better than butter on bread. Now we maintain a broken build system which
doesn't work with python3.

But hey we have install_with_python.sh which downloads and builds python2 for
us, that's future proof!

:-P



Reply | Threaded
Open this post in threaded view
|

Re: docs: Building with Makefile

Samba - samba-technical mailing list
On Sat, Jan 06, 2018 at 05:48:17PM +0100, Andreas Schneider via samba-technical wrote:

> On Saturday, 6 January 2018 03:18:11 CET Richard Sharpe via samba-technical
> wrote:
> > On Fri, Jan 5, 2018 at 12:18 PM, Andreas Schneider via samba-technical
> >
> > <[hidden email]> wrote:
> > > On Friday, 5 January 2018 19:56:02 CET Björn Jacke wrote:
> > >> The branch, master has been updated
> > >>
> > >>        via  3cbeaf4 docs-xml: add basic Makefile dependencies for targets
> > >>
> > >> that use xsltproc via  9b27948 docs-xml: set a reasonable
> > >> XML_CATALOG_FILES
> > >> in Makefile via  a2f5b3b docs-xml: generate build/catalog.xml via
> > >> Makefile
> > >> target from  2245a4b autobuild: fix quoting of --restrict-tests
> > >>
> > >> https://git.samba.org/?p=samba.git;a=shortlog;h=master
> > >>
> > >>
> > >> - Log -----------------------------------------------------------------
> > >> commit 3cbeaf40937082bd7072d715ae02aa0989835432
> > >> Author: Björn Jacke <[hidden email]>
> > >> Date:   Thu Jan 4 16:35:12 2018 +0100
> > >>
> > >>     docs-xml: add basic Makefile dependencies for targets that use
> > >>     xsltproc
> > >
> > > Why do you build with Makefile? Is the stuff in waf so bad?
> >
> > Waf is a heap of shit that invalidates all my other knowledge about
> > autotools and removes functionality we used to have, like out-of-tree
> > builds of VFS modules.
>
> Hey, I was the one who wanted to use CMake but then someone told me that waf
> is better than butter on bread. Now we maintain a broken build system which
> doesn't work with python3.
>
> But hey we have install_with_python.sh which downloads and builds python2 for
> us, that's future proof!
>
> :-P

IMHO waf has not been a success, even though Metze likes
the fact it is raw python :-). I don't think anyone expected
that python2 and python3 would be entirely different languages :-).

Jeremy.

Reply | Threaded
Open this post in threaded view
|

Re: docs: Building with Makefile

Samba - samba-technical mailing list
In reply to this post by Samba - samba-technical mailing list
On Sat, Jan 06, 2018 at 05:48:17PM +0100, Andreas Schneider via samba-technical wrote:

> On Saturday, 6 January 2018 03:18:11 CET Richard Sharpe via samba-technical
> wrote:
> > On Fri, Jan 5, 2018 at 12:18 PM, Andreas Schneider via samba-technical
> >
> > <[hidden email]> wrote:
> > > On Friday, 5 January 2018 19:56:02 CET Björn Jacke wrote:
> > >> The branch, master has been updated
> > >>
> > >>        via  3cbeaf4 docs-xml: add basic Makefile dependencies for targets
> > >>
> > >> that use xsltproc via  9b27948 docs-xml: set a reasonable
> > >> XML_CATALOG_FILES
> > >> in Makefile via  a2f5b3b docs-xml: generate build/catalog.xml via
> > >> Makefile
> > >> target from  2245a4b autobuild: fix quoting of --restrict-tests
> > >>
> > >> https://git.samba.org/?p=samba.git;a=shortlog;h=master
> > >>
> > >>
> > >> - Log -----------------------------------------------------------------
> > >> commit 3cbeaf40937082bd7072d715ae02aa0989835432
> > >> Author: Björn Jacke <[hidden email]>
> > >> Date:   Thu Jan 4 16:35:12 2018 +0100
> > >>
> > >>     docs-xml: add basic Makefile dependencies for targets that use
> > >>     xsltproc
> > >
> > > Why do you build with Makefile? Is the stuff in waf so bad?
> >
> > Waf is a heap of shit that invalidates all my other knowledge about
> > autotools and removes functionality we used to have, like out-of-tree
> > builds of VFS modules.
>
> Hey, I was the one who wanted to use CMake but then someone told me that waf
> is better than butter on bread. Now we maintain a broken build system which
> doesn't work with python3.

Yes, I remember being very encouraging when you wanted CMake. I'm sorry
I didn't win that battle :-(.

Reply | Threaded
Open this post in threaded view
|

Re: docs: Building with Makefile

Samba - samba-technical mailing list
In reply to this post by Samba - samba-technical mailing list
On Saturday, 6 January 2018 20:48:14 CET Jeremy Allison wrote:
> On Sat, Jan 06, 2018 at 05:48:17PM +0100, Andreas Schneider via samba-
technical wrote:

> > On Saturday, 6 January 2018 03:18:11 CET Richard Sharpe via
> > samba-technical
> >
> > wrote:
> > > On Fri, Jan 5, 2018 at 12:18 PM, Andreas Schneider via samba-technical
> > >
> > > <[hidden email]> wrote:
> > > > On Friday, 5 January 2018 19:56:02 CET Björn Jacke wrote:
> > > >> The branch, master has been updated
> > > >>
> > > >>        via  3cbeaf4 docs-xml: add basic Makefile dependencies for
> > > >>        targets
> > > >>
> > > >> that use xsltproc via  9b27948 docs-xml: set a reasonable
> > > >> XML_CATALOG_FILES
> > > >> in Makefile via  a2f5b3b docs-xml: generate build/catalog.xml via
> > > >> Makefile
> > > >> target from  2245a4b autobuild: fix quoting of --restrict-tests
> > > >>
> > > >> https://git.samba.org/?p=samba.git;a=shortlog;h=master
> > > >>
> > > >>
> > > >> - Log
> > > >> -----------------------------------------------------------------
> > > >> commit 3cbeaf40937082bd7072d715ae02aa0989835432
> > > >> Author: Björn Jacke <[hidden email]>
> > > >> Date:   Thu Jan 4 16:35:12 2018 +0100
> > > >>
> > > >>     docs-xml: add basic Makefile dependencies for targets that use
> > > >>     xsltproc
> > > >
> > > > Why do you build with Makefile? Is the stuff in waf so bad?
> > >
> > > Waf is a heap of shit that invalidates all my other knowledge about
> > > autotools and removes functionality we used to have, like out-of-tree
> > > builds of VFS modules.
> >
> > Hey, I was the one who wanted to use CMake but then someone told me that
> > waf is better than butter on bread. Now we maintain a broken build system
> > which doesn't work with python3.
> >
> > But hey we have install_with_python.sh which downloads and builds python2
> > for us, that's future proof!
> >
> > :-P
>
> IMHO waf has not been a success, even though Metze likes
> the fact it is raw python :-). I don't think anyone expected
> that python2 and python3 would be entirely different languages :-).

Distritubtions are working on deprecating python2. This means it will be
completely removed.



Reply | Threaded
Open this post in threaded view
|

Fwd: docs: Building with Makefile

Samba - samba-technical mailing list
On Sun, Jan 7, 2018 at 11:16 AM, Andreas Schneider via samba-technical <
[hidden email]> wrote:

> On Saturday, 6 January 2018 20:48:14 CET Jeremy Allison wrote:
> > On Sat, Jan 06, 2018 at 05:48:17PM +0100, Andreas Schneider via samba-
> technical wrote:
> > > On Saturday, 6 January 2018 03:18:11 CET Richard Sharpe via
> > > samba-technical
> > >
> > > wrote:
> > > > On Fri, Jan 5, 2018 at 12:18 PM, Andreas Schneider via
> samba-technical
> > > >
> > > > <[hidden email]> wrote:
> > > > > On Friday, 5 January 2018 19:56:02 CET Björn Jacke wrote:
> > > > >> The branch, master has been updated
> > > > >>
> > > > >>        via  3cbeaf4 docs-xml: add basic Makefile dependencies for
> > > > >>        targets
> > > > >>
> > > > >> that use xsltproc via  9b27948 docs-xml: set a reasonable
> > > > >> XML_CATALOG_FILES
> > > > >> in Makefile via  a2f5b3b docs-xml: generate build/catalog.xml via
> > > > >> Makefile
> > > > >> target from  2245a4b autobuild: fix quoting of --restrict-tests
> > > > >>
> > > > >> https://git.samba.org/?p=samba.git;a=shortlog;h=master
> > > > >>
> > > > >>
> > > > >> - Log
> > > > >> -----------------------------------------------------------------
> > > > >> commit 3cbeaf40937082bd7072d715ae02aa0989835432
> > > > >> Author: Björn Jacke <[hidden email]>
> > > > >> Date:   Thu Jan 4 16:35:12 2018 +0100
> > > > >>
> > > > >>     docs-xml: add basic Makefile dependencies for targets that use
> > > > >>     xsltproc
> > > > >
> > > > > Why do you build with Makefile? Is the stuff in waf so bad?
> > > >
> > > > Waf is a heap of shit that invalidates all my other knowledge about
> > > > autotools and removes functionality we used to have, like out-of-tree
> > > > builds of VFS modules.
> > >
> > > Hey, I was the one who wanted to use CMake but then someone told me
> that
> > > waf is better than butter on bread. Now we maintain a broken build
> system
> > > which doesn't work with python3.
> > >
> > > But hey we have install_with_python.sh which downloads and builds
> python2
> > > for us, that's future proof!
> > >
> > > :-P
> >
> > IMHO waf has not been a success, even though Metze likes
> > the fact it is raw python :-). I don't think anyone expected
> > that python2 and python3 would be entirely different languages :-).
>
> Distritubtions are working on deprecating python2. This means it will be
> completely removed


I believe Jelmer once worked on switching to WAF 1.8.0, which was already
Python3 friendly.

I guess, from there it would be easier to leap to the WAF 2.0.4. We still
have some artifacts of
not fully porting from autotools to WAF, so converting to yet another build
system will make that
pain doubled.
Reply | Threaded
Open this post in threaded view
|

Re: docs: Building with Makefile

Samba - samba-technical mailing list
In reply to this post by Samba - samba-technical mailing list
On 2018-01-05 at 21:18 +0100 Andreas Schneider via samba-technical sent off:
> Why do you build with Makefile? Is the stuff in waf so bad?

simple Makefile with cleaned up dependencies just works best for me.
The waf doc build is a complex beast and I find it way more difficult to
oversee than the Makefile docs build. It starts with the point that there is no
dedicated waf make target for the docs as far as I can see.

Björn