Anton Zinoviev <anton@lml.bas.bg> writes:
> On Thu, Feb 09, 2006 at 01:54:27PM -0800, Thomas Bushnell BSG wrote:
>>
>> It does prohibit some modifications which are useful.
>>
>> Geez, reference cards. Useful!
>
> You can make reference cards but if you make more than 100 copies you
> have to accompany the reference cards with additional sheet(s) of
> paper. The other licenses have the same limitation - you may not
> distribute the reference cards alone. Depending on the license you
> may be required to accompany each reference card with the full text of
> the license, with history who and when has edited the document, with
> the sources in machine readable format, various copyright notices, etc.
You neglected to mention what happens about reference cards for
documentation with invariant sections. Reference cards for Emacs and
GCC would be most useful, but AFAICT both of these manuals have
invariant sections.
>> Docstrings. Useful! Not prohibited by other free licenses! Wow!
>
> I don't understand what you mean by "docstrings".
Did you try google? They are documentation inlined in the source
code. Some languages (e.g. Python (DocStrings), Perl (POD), Common
Lisp) have native support for it; other languages (C, ObjC, C++, Java)
have special tools to extract the documentation (gtk-doc, doc++,
doxygen, javadoc).
If you want an example of it, grab a copy of
https://alioth.debian.org/download.php/1437/schroot-0.2.2.tar.bz2, and
look at the comments in schroot/*.h, then look at
doc/schroot/html/index.html.
Consider what happens if the documentation is extracted and
incorporated into a manual with a GFDL licence, and the source is GPL.
In other situations, we might want to incorporate parts of the manual
into the source (for tooltips, help texts, usage examples, etc..). We
certainly couldn't do that with a GFDL manual and GPL source.
Regards,
Roger
--
Roger Leigh
Printing on GNU/Linux? http://gutenprint.sourceforge.net/
Debian GNU/Linux http://www.debian.org/
GPG Public Key: 0x25BFB848. Please sign and encrypt your mail.
Attachment:
pgpyVtm8kO5E0.pgp
Description: PGP signature