[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [STUMP] Drop the generation of stumpwm.texi
From: |
Diogo F. S. Ramos |
Subject: |
Re: [STUMP] Drop the generation of stumpwm.texi |
Date: |
Mon, 17 Nov 2014 15:13:10 -0200 |
User-agent: |
Gnus/5.13 (Gnus v5.13) Emacs/24.3 (gnu/linux) |
> I don't think the reduction in complexity will result in a
> gain in productivity. If we decouple stumpwm.texi from the source,
> we'll have to maintain the docstrings and the documentation. As it
> stands right now, adding a function to the manual is a fairly
> straightforward procedure of flagging the right symbols and the
> makefile creates the appropriate stumpwm.texi file.
The complexity reduction is one of the benefits which I see in this.
There is also the fact that by editing `stumpwm.tex.in', sometimes it is
not clear how the manual will turn up because there is still the
processing part.
But maybe most importantly, I think docstrings and the manual should be
separate entities. Which means that, by separating them, there should
not be more work to manually move text from the docstrings to function
definitions in the manual, but that some texts might be similar for the
functions which are mentioned in the manual.
- [STUMP] Drop the generation of stumpwm.texi, Diogo F. S. Ramos, 2014/11/16
- Re: [STUMP] Drop the generation of stumpwm.texi, David Bjergaard, 2014/11/17
- Re: [STUMP] Drop the generation of stumpwm.texi,
Diogo F. S. Ramos <=
- Re: [STUMP] Drop the generation of stumpwm.texi, David Bjergaard, 2014/11/17
- Re: [STUMP] Drop the generation of stumpwm.texi, Diogo F. S. Ramos, 2014/11/17
- Re: [STUMP] Drop the generation of stumpwm.texi, David Bjergaard, 2014/11/17
- Re: [STUMP] Drop the generation of stumpwm.texi, Diogo F. S. Ramos, 2014/11/17
- Re: [STUMP] Drop the generation of stumpwm.texi, David Bjergaard, 2014/11/17
- Re: [STUMP] Drop the generation of stumpwm.texi, Diogo F. S. Ramos, 2014/11/17
- Re: [STUMP] Drop the generation of stumpwm.texi, David Bjergaard, 2014/11/17
- Re: [STUMP] Drop the generation of stumpwm.texi, Ivan Kanis, 2014/11/18
- Re: [STUMP] Drop the generation of stumpwm.texi, David Bjergaard, 2014/11/18
- Re: [STUMP] Drop the generation of stumpwm.texi, Diogo F. S. Ramos, 2014/11/18