htswanalysis/MACS/lib/gsl/gsl-1.11/doc/freemanuals.texi

   1 @cindex free documentation
   2
   3 @quotation
   4 @i{The following article was written by Richard Stallman, founder of the
   5 GNU Project.}
   6 @end quotation
   7
   8
   9 The biggest deficiency in the free software community today is not in
  10 the software---it is the lack of good free documentation that we can
  11 include with the free software.  Many of our most important
  12 programs do not come with free reference manuals and free introductory
  13 texts.  Documentation is an essential part of any software package;
  14 when an important free software package does not come with a free
  15 manual and a free tutorial, that is a major gap.  We have many such
  16 gaps today.
  17
  18 Consider Perl, for instance.  The tutorial manuals that people
  19 normally use are non-free.  How did this come about?  Because the
  20 authors of those manuals published them with restrictive terms---no
  21 copying, no modification, source files not available---which exclude
  22 them from the free software world.
  23
  24 That wasn't the first time this sort of thing happened, and it was far
  25 from the last.  Many times we have heard a GNU user eagerly describe a
  26 manual that he is writing, his intended contribution to the community,
  27 only to learn that he had ruined everything by signing a publication
  28 contract to make it non-free.
  29
  30 Free documentation, like free software, is a matter of freedom, not
  31 price.  The problem with the non-free manual is not that publishers
  32 charge a price for printed copies---that in itself is fine.  (The Free
  33 Software Foundation sells printed copies of manuals, too.)  The
  34 problem is the restrictions on the use of the manual.  Free manuals
  35 are available in source code form, and give you permission to copy and
  36 modify.  Non-free manuals do not allow this.
  37
  38 The criteria of freedom for a free manual are roughly the same as for
  39 free software.  Redistribution (including the normal kinds of
  40 commercial redistribution) must be permitted, so that the manual can
  41 accompany every copy of the program, both on-line and on paper.
  42
  43 Permission for modification of the technical content is crucial too.
  44 When people modify the software, adding or changing features, if they
  45 are conscientious they will change the manual too---so they can
  46 provide accurate and clear documentation for the modified program.  A
  47 manual that leaves you no choice but to write a new manual to document
  48 a changed version of the program is not really available to our
  49 community.
  50
  51 Some kinds of limits on the way modification is handled are
  52 acceptable.  For example, requirements to preserve the original
  53 author's copyright notice, the distribution terms, or the list of
  54 authors, are ok.  It is also no problem to require modified versions
  55 to include notice that they were modified.  Even entire sections that
  56 may not be deleted or changed are acceptable, as long as they deal
  57 with nontechnical topics (like this one).  These kinds of restrictions
  58 are acceptable because they don't obstruct the community's normal use
  59 of the manual.
  60
  61 However, it must be possible to modify all the @emph{technical}
  62 content of the manual, and then distribute the result in all the usual
  63 media, through all the usual channels.  Otherwise, the restrictions
  64 obstruct the use of the manual, it is not free, and we need another
  65 manual to replace it.
  66
  67 Please spread the word about this issue.  Our community continues to
  68 lose manuals to proprietary publishing.  If we spread the word that
  69 free software needs free reference manuals and free tutorials, perhaps
  70 the next person who wants to contribute by writing documentation will
  71 realize, before it is too late, that only free manuals contribute to
  72 the free software community.
  73
  74 If you are writing documentation, please insist on publishing it under
  75 the GNU Free Documentation License or another free documentation
  76 license.  Remember that this decision requires your approval---you
  77 don't have to let the publisher decide.  Some commercial publishers
  78 will use a free license if you insist, but they will not propose the
  79 option; it is up to you to raise the issue and say firmly that this is
  80 what you want.  If the publisher you are dealing with refuses, please
  81 try other publishers.  If you're not sure whether a proposed license
  82 is free, write to @email{licensing@@gnu.org}.
  83
  84 You can encourage commercial publishers to sell more free, copylefted
  85 manuals and tutorials by buying them, and particularly by buying
  86 copies from the publishers that paid for their writing or for major
  87 improvements.  Meanwhile, try to avoid buying non-free documentation
  88 at all.  Check the distribution terms of a manual before you buy it,
  89 and insist that whoever seeks your business must respect your freedom.
  90 Check the history of the book, and try reward the publishers that have
  91 paid or pay the authors to work on it.
  92
  93 The Free Software Foundation maintains a list of free documentation
  94 published by other publishers:
  95
  96 @itemize @asis
  97 @item
  98 @uref{http://www.fsf.org/doc/other-free-books.html}
  99 @end itemize