libstdc++-v3/doc/html/manual/appendix_free.html

   1 <?xml version="1.0" encoding="UTF-8" standalone="no"?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
   3 <html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Appendix C.  Free Software Needs Free Documentation</title><meta name="generator" content="DocBook XSL Stylesheets V1.74.3" /><meta name="keywords" content="&#10;      ISO C++&#10;    , &#10;      library&#10;    " /><link rel="home" href="../spine.html" title="The GNU C++ Library Documentation" /><link rel="up" href="spine.html" title="The GNU C++ Library" /><link rel="prev" href="backwards.html" title="Backwards Compatibility" /><link rel="next" href="appendix_gpl.html" title="Appendix D.  GNU General Public License version 3" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Appendix C.
   4   Free Software Needs Free Documentation
   5
   6 </th></tr><tr><td width="20%" align="left"><a accesskey="p" href="backwards.html">Prev</a> </td><th width="60%" align="center">The GNU C++ Library</th><td width="20%" align="right"> <a accesskey="n" href="appendix_gpl.html">Next</a></td></tr></table><hr /></div><div class="appendix" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title"><a id="appendix.free"></a>Appendix C.
   7   Free Software Needs Free Documentation
   8   <a id="id675332" class="indexterm"></a>
   9 </h2></div></div></div><p>
  10 The biggest deficiency in free operating systems is not in the
  11 software--it is the lack of good free manuals that we can include in
  12 these systems.  Many of our most important programs do not come with
  13 full manuals.  Documentation is an essential part of any software
  14 package; when an important free software package does not come with a
  15 free manual, that is a major gap.  We have many such gaps today.
  16 </p><p>
  17 Once upon a time, many years ago, I thought I would learn Perl.  I got
  18 a copy of a free manual, but I found it hard to read.  When I asked
  19 Perl users about alternatives, they told me that there were better
  20 introductory manuals--but those were not free.
  21 </p><p>
  22 Why was this?  The authors of the good manuals had written them for
  23 O'Reilly Associates, which published them with restrictive terms--no
  24 copying, no modification, source files not available--which exclude
  25 them from the free software community.
  26 </p><p>
  27 That wasn't the first time this sort of thing has happened, and (to
  28 our community's great loss) it was far from the last.  Proprietary
  29 manual publishers have enticed a great many authors to restrict their
  30 manuals since then.  Many times I have heard a GNU user eagerly tell
  31 me about a manual that he is writing, with which he expects to help
  32 the GNU project--and then had my hopes dashed, as he proceeded to
  33 explain that he had signed a contract with a publisher that would
  34 restrict it so that we cannot use it.
  35 </p><p>
  36 Given that writing good English is a rare skill among programmers, we
  37 can ill afford to lose manuals this way.
  38 </p><p>
  39   Free documentation, like free software, is a matter of freedom,
  40 not price.  The problem with these manuals was not that O'Reilly
  41 Associates charged a price for printed copies--that in itself is fine.
  42 (The Free Software Foundation <a class="ulink" href="http://www.gnu.org/doc/doc.html" target="_top">sells printed copies</a> of
  43 free GNU manuals, too.)  But GNU manuals are available in source code
  44 form, while these manuals are available only on paper.  GNU manuals
  45 come with permission to copy and modify; the Perl manuals do not.
  46 These restrictions are the problems.
  47 </p><p>
  48 The criterion for a free manual is pretty much the same as for free
  49 software: it is a matter of giving all users certain freedoms.
  50 Redistribution (including commercial redistribution) must be
  51 permitted, so that the manual can accompany every copy of the program,
  52 on-line or on paper.  Permission for modification is crucial too.
  53 </p><p>
  54 As a general rule, I don't believe that it is essential for people to
  55 have permission to modify all sorts of articles and books.  The issues
  56 for writings are not necessarily the same as those for software.  For
  57 example, I don't think you or I are obliged to give permission to
  58 modify articles like this one, which describe our actions and our
  59 views.
  60 </p><p>
  61 But there is a particular reason why the freedom to modify is crucial
  62 for documentation for free software.  When people exercise their right
  63 to modify the software, and add or change its features, if they are
  64 conscientious they will change the manual too--so they can provide
  65 accurate and usable documentation with the modified program.  A manual
  66 which forbids programmers to be conscientious and finish the job, or
  67 more precisely requires them to write a new manual from scratch if
  68 they change the program, does not fill our community's needs.
  69 </p><p>
  70 While a blanket prohibition on modification is unacceptable, some
  71 kinds of limits on the method of modification pose no problem.  For
  72 example, requirements to preserve the original author's copyright
  73 notice, the distribution terms, or the list of authors, are ok.  It is
  74 also no problem to require modified versions to include notice that
  75 they were modified, even to have entire sections that may not be
  76 deleted or changed, as long as these sections deal with nontechnical
  77 topics.  (Some GNU manuals have them.)
  78 </p><p>
  79 These kinds of restrictions are not a problem because, as a practical
  80 matter, they don't stop the conscientious programmer from adapting the
  81 manual to fit the modified program.  In other words, they don't block
  82 the free software community from making full use of the manual.
  83 </p><p>
  84 However, it must be possible to modify all the <span class="emphasis"><em>technical</em></span>
  85 content of the manual, and then distribute the result in all the usual
  86 media, through all the usual channels; otherwise, the restrictions do
  87 block the community, the manual is not free, and so we need another
  88 manual.
  89 </p><p>
  90 Unfortunately, it is often hard to find someone to write another
  91 manual when a proprietary manual exists.  The obstacle is that many
  92 users think that a proprietary manual is good enough--so they don't
  93 see the need to write a free manual.  They do not see that the free
  94 operating system has a gap that needs filling.
  95 </p><p>
  96 Why do users think that proprietary manuals are good enough?  Some
  97 have not considered the issue.  I hope this article will do something
  98 to change that.
  99 </p><p>
 100 Other users consider proprietary manuals acceptable for the same
 101 reason so many people consider proprietary software acceptable: they
 102 judge in purely practical terms, not using freedom as a criterion.
 103 These people are entitled to their opinions, but since those opinions
 104 spring from values which do not include freedom, they are no guide for
 105 those of us who do value freedom.
 106 </p><p>
 107 Please spread the word about this issue.  We continue to lose manuals
 108 to proprietary publishing.  If we spread the word that proprietary
 109 manuals are not sufficient, perhaps the next person who wants to help
 110 GNU by writing documentation will realize, before it is too late, that
 111 he must above all make it free.
 112 </p><p>
 113 We can also encourage commercial publishers to sell free, copylefted
 114 manuals instead of proprietary ones.  One way you can help this is to
 115 check the distribution terms of a manual before you buy it, and
 116 prefer copylefted manuals to non-copylefted ones.
 117 </p><p>
 118 [Note: We now maintain a <a class="ulink" href="http://www.fsf.org/licensing/doc/other-free-books.html" target="_top">web page
 119 that lists free books available from other publishers</a>].
 120 </p><p>Copyright © 2004, 2005, 2006, 2007 Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA</p><p>Verbatim copying and distribution of this entire article are
 121 permitted worldwide, without royalty, in any medium, provided this
 122 notice is preserved.</p><p>Report any problems or suggestions to <code class="email">&lt;<a class="email" href="mailto:webmaster@fsf.org">webmaster@fsf.org</a>&gt;</code>.</p></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="backwards.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="spine.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="appendix_gpl.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Backwards Compatibility </td><td width="20%" align="center"><a accesskey="h" href="../spine.html">Home</a></td><td width="40%" align="right" valign="top"> Appendix D.
 123     GNU General Public License version 3
 124   </td></tr></table></div></body></html>