-
Notifications
You must be signed in to change notification settings - Fork 17
/
FAQ.txt
154 lines (117 loc) · 5.87 KB
/
FAQ.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
1. OK, I have downloaded this stuff. What do I do now?
A. Type "make" from the top-level directory. If all goes
well, this will produce a file named "perfbook-2up.pdf",
which prints two virtual pages per physical page.
2. The Makefile cannot find pdflatex. What is it and where can I
find it?
A. The "pdflatex" package is a variant of Don Knuth's
digital typesetting program. On Ubuntu Maverick,
installing the following set of packages suffices:
texlive-latex-base texlive-latex-extra psutils
texlive-publishers-doc texlive-fonts-extra
texlive-math-extra texlive-publishers
texlive-science texlive-bibtex-extra latex2html
gnuplot-x11 xfig
Other systems might provide similarly named packages.
For example, Doug Miller noted that the following list
of teTeX components worked for him on RHEL5:
tetex tetex-afm tetex-dvips tetex-latex latex2html
texinfo tetex-fonts tetex-doc tetex-xdvi
3. Why the heck did you use this strange-looking text-based
ca. 1980s typesetting package instead of something more
modern, like OpenOffice?
A. Although latex takes a bit of getting used to, its
automatic handling of bibliographies, tables of contents,
figures, and tables is extremely useful for large documents.
In addition, its text-based nature is much more compatible
with modern source-code-control systems such as "git".
Finally, the more-modern WYSIWYG text formatters tend
to get a bit cranky when working with hundreds-of-pages
documents.
4. Where can I purchase a hardcopy of this book?
A. You can use any of a number of web-based printing
services, for but one example, lulu.com. Images suitable
for cover art may be found in CoverFront.jpg and
CoverBack.jpg in the cartoons directory.
5. This book doesn't mention my favorite parallel-programming
tools, languages, and algorithms. Plus its Makefile and
Latex formatting are imperfect. What is up with that?
A. Please see the following question.
6. Can I contribute?
A. Of course!!! The contribution process is similar to that
of the Linux kernel and of the Samba project. See the
Documentation/SubmittingPatches file in a Linux source tree.
Please put a "Signed-off-by:" line in your patches,
for an example see: http://lkml.org/lkml/2007/1/15/219.
This "Signed-off-by:" line has a very specific meaning as
follows:
---------------------------------------------------------
By making a contribution to this project, I certify that:
1. The contribution was created in whole or in part
by me and I have the right to submit it under
the open source license indicated in the file; or
2. The contribution is based upon previous work
that, to the best of my knowledge, is covered
under an appropriate open source License and I
have the right under that license to submit that
work with modifications, whether created in whole
or in part by me, under the same open source
license (unless I am permitted to submit under
a different license), as indicated in the file; or
3. The contribution was provided directly to me by
some other person who certified (a), (b) or (c)
and I have not modified it.
4. The contribution is made free of any other party's
intellectual property claims or rights.
5. I understand and agree that this project and the
contribution are public and that a record of the
contribution (including all personal information
I submit with it, including my sign-off) is
maintained indefinitely and may be redistributed
consistent with this project or the open source
license(s) involved.
---------------------------------------------------------
This is similar to the DCO used for the Linux kernel,
with the addition of #4. This says that you wrote
the contribution yourself, as opposed to having (say)
copied it from somewhere. If multiple people authored
a contribution, each should have a "Signed-off-by:" line.
7. May I have permission to translate this book to my native
language?
A. Of course! In any case, this permission is implicitly
granted by the choice of the Creative Commons
Attribution-Share Alike 3.0 United States license for
the text and GPL for the code.
Please keep in mind that all translations must preserve
the licenses.
A project translating the book to Chinese is well underway,
and there are rumors of other translation efforts as well.
People who have worked on the Chinese translations
include: 谢宝友([email protected],[email protected]),
鲁阳([email protected]), 陈渝([email protected]),
Cheedoong Drung ([email protected]), and 王贺涛
<[email protected]>. Please contact them to contribute
to their good work.
See http://code.taobao.org/p/perfbook/src/ for more
information on Cheedoong Drung's and 王贺涛's effort.
For a PDF of the translation by 谢宝友, 鲁阳, and 陈渝,
please see:
http://kernel.org/pub/linux/kernel/people/paulmck/perfbook/perfbook-cn.2011.10.18a.pdf
8. I hate Quick Quizzes!!! Could you please get rid of them?
A. Quite a few people like them a lot, so they will be
staying. However, you can easily produce a copy of the
book that omits the Quick Quizzes by editing the Makefile
and qqz.sty files in the top-level directory.
One approach is to make the "\QuickQuiz" command in
qqz.sty be a no-op and to add line to the Makefile that
transforms "perfbook_flat.tex" by removing the Quick
Quizzes, each of which starts with the line "\QuickQuiz{}"
and ends with the line "} \QuickQuizEnd".
This transformation should happen after the invocation
of "utilities/extractqqz.sh" in the "perfbook_flat.tex"
Makefile rule. This would remove the inlined Quick
Quizzes from the running text, but retain the chapter
containing the answers. It should be possible to move
each chapter's Quick Quizzes to the end of that chapter,
but that would require more work and is left as an
exercise to the reader.