Download Developing software with GNU

iv
Developing software with GNU
10 Maintaining Documentation . . . . . . . . . . . . . 107
10.1
10.2
10.3
10.4
10.5
10.6
10.7
10.8
10.9
Browsing documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Writing proper manuals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Introduction to Texinfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Markup in Texinfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
GNU Emacs support for Texinfo . . . . . . . . . . . . . . . . . . . . . .
Writing man pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Writing documentation with LaTeX . . . . . . . . . . . . . . . . . . .
Creating a LaTeX package . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Further reading about LaTeX . . . . . . . . . . . . . . . . . . . . . . . . .
107
107
107
107
107
107
107
107
107
11 Portable shell programming . . . . . . . . . . . . . 109
12 Writing Autoconf macros . . . . . . . . . . . . . . . 111
Appendix A Legal issues with Free Software
.......................................
113
A.1 Understanding Copyright . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
A.2 Software patents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
A.3 Export restrictions on encryption software . . . . . . . . . . . . . . 115
Appendix B Philosophical issues . . . . . . . . . . . 117
B.1
B.2
B.3
B.4
B.5
B.6
The Right to Read . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
What is Free Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Why software should not have owners . . . . . . . . . . . . . . . . . .
Why free software needs free documentation . . . . . . . . . . . .
Categories of software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Confusing words . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
117
120
120
124
126
129
Appendix C Licensing Free Software . . . . . . . . 131
C.1 What is Copyleft . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
C.2 Why you should use the GPL . . . . . . . . . . . . . . . . . . . . . . . . . . 132
C.3 The LGPL vs the GPL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
Appendix D GNU GENERAL PUBLIC
LICENSE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
D.1 Preamble . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
D.2 TERMS AND CONDITIONS FOR COPYING,
DISTRIBUTION AND MODIFICATION . . . . . . . . . . . . . . . 138
D.3 Appendix: How to Apply These Terms to Your New
Programs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142