[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [STUMP] Drop the generation of stumpwm.texi
From: |
David Bjergaard |
Subject: |
Re: [STUMP] Drop the generation of stumpwm.texi |
Date: |
Mon, 17 Nov 2014 14:29:04 -0500 |
User-agent: |
Gnus/5.13 (Gnus v5.13) Emacs/24.4 (gnu/linux) |
"Diogo F. S. Ramos" <address@hidden> writes:
>> Maybe we can address your concerns another way. Besides reducing
>> complexity (which I agree, this proposal does), was there a reason that
>> you felt the need to make these changes?
>
> Reducing the complexity was not my only concern, like I stated before,
> but thank you for the care.
Can you elaborate, I know that it may feel like I'm not listening, but I
feel like I'm missing a deeper point. As I understand this (please,
please correct me):
1. A lisp docstring and a manual entry are two different things.
2. Scraping source code to generate documentation is awkward/bad/ugly.
3. Its hard to edit the manual and know what the final version is going
to look like.
Therefore, it makes sense to decouple the manual from the docstrings and
maintain a pedagogical info document, as well as the doc strings for
lisp hackers who are working with the source code directly.
Is this a fair assessment?
Cheers,
Dave
- [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, 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 <=
- 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
- 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
- Re: [STUMP] Drop the generation of stumpwm.texi, David Bjergaard, 2014/11/18