Commit graph

870 commits

Author SHA1 Message Date
Bradley M. Kuhn
5add1b9f4d Remove additional stuff. 2014-11-06 16:19:48 -05:00
Bradley M. Kuhn
aab19d9e4c Use \url here instead of \verb0URL0 2014-11-06 16:04:45 -05:00
Bradley M. Kuhn
daf8915cb8 Create symlink for index.html: temporary hack. 2014-11-06 15:48:53 -05:00
Bradley M. Kuhn
527125f08d Improve dependency and cleanups. 2014-11-06 15:15:17 -05:00
Bradley M. Kuhn
20bae66371 Correct to not have body > 2014-11-06 15:14:57 -05:00
Bradley M. Kuhn
6037a3726d Additional CSS to beautify the Guide.
HT jgay who pasted this to me on IRC.
2014-11-06 14:51:08 -05:00
Bradley M. Kuhn
913551b960 Add css for guide and include it from webhacks. 2014-11-06 14:49:23 -05:00
Bradley M. Kuhn
c568e41728 Commands to install right Debian packages. 2014-11-06 13:21:39 -05:00
Bradley M. Kuhn
17c3de45ce BOOK_CLASS_FILE is not used.
It was a vestige from old Makefile.
2014-11-06 13:21:16 -05:00
Bradley M. Kuhn
d45e79218b Install configuration. 2014-11-06 12:41:31 -05:00
Bradley M. Kuhn
441df63ee7 Hack tex4ht's overlib stuff to use jQuery tooltip
tex4ht supports "overlib" for footnote popups.  The hack is pretty
straightforward; it dumps a Javascript area into a .js file that can
then be used by overlib to popup stuff.

This hack is to use that output to make the same thing work with jQuery
UI's tooltip widget.

Note that we run with overlib support first, then *without* it in the
Makefile setup.  This is to force the needed .js file to be generated,
but make sure the HTML doesn't try to load overlib (which is default).

(This should be adapted as a patch to upstream tex4ht ultimately.)

Also included herein are improvements to the Makefile to build the HTML
output.
2014-11-06 12:34:18 -05:00
Bradley M. Kuhn
87a9a059d4 A few temporary formatting hacks.
Put \verb0_0 around _'s and use \url{} for the url.
2014-11-06 08:25:55 -05:00
Bradley M. Kuhn
c14feb3df0 Fix formatting error. 2014-11-06 08:23:47 -05:00
Bradley M. Kuhn
615e498d9f First version of Makefile for this project. 2014-11-06 08:22:46 -05:00
Denver Gingerich
fce20d7af3 Add rootfs and U-Boot install notes to case study
This change also fixes the location of the multiple image note, which
is better included after the note added in 3c15418 so that it's clear
what "This step" refers to.

Also added were notes on how we checked to confirm the kernel was
corresponding and commentary on why the toolchain issue was much less
severe than the toolchain issues we usually see.
2014-11-02 16:49:23 -05:00
Denver Gingerich
3c1541897c Add compliance tips on tricky steps to case study
Additionally, remove an unneeded FIXME and clarify an existing FIXME
so we know the title is ok for now, but the section needs format fix.
2014-11-02 15:40:43 -05:00
Denver Gingerich
573bd70b2f Add log files from the build steps, mention in doc 2014-11-02 12:41:25 -05:00
Denver Gingerich
c36b248e01 Fix typo in name: "ThinkPengiun" -> "ThinkPenguin"
This typo was introduced when the section was first added, in 5c22a2b.
2014-11-02 11:54:56 -05:00
Denver Gingerich
2c4923c70f Add firmware comparison section showing steps used 2014-10-25 19:49:47 -04:00
Denver Gingerich
60a400c18f Update build notes to be more "walk through"-style 2014-10-25 19:45:56 -04:00
Bradley M. Kuhn
813687673a A few additional ideas on how this section could be expanded 2014-10-25 00:02:26 -07:00
Bradley M. Kuhn
e7ec09b24d Note for later work to be added on this issue 2014-10-24 23:57:52 -07:00
Bradley M. Kuhn
2eb7082e68 Rework first paragraph 2014-10-24 23:56:11 -07:00
Bradley M. Kuhn
acfc254561 Expand title a bit 2014-10-24 23:54:19 -07:00
Denver Gingerich
5c22a2b18c Add chapter on router with included source CD
Note that this chapter is not properly TeX-formatted.  Some work will
need to be done to make it compile correctly.  It should also be
generally expanded and made to flow more nicely, in the spirit of the
other case study chapters.
2014-10-18 18:49:39 -04:00
Bradley M. Kuhn
4a40f09f14 Typo fix. 2014-10-16 10:38:01 -04:00
Bradley M. Kuhn
cc151f6da6 Reaame TODOS/README.md to TODO.md
I think we should just put this in the top level directory.
2014-10-15 22:26:23 -04:00
Michael R. Bernstein
22558e9e24 Added link to todo for creating EPUBs from LaTeX. 2014-10-15 22:26:09 -04:00
Michael R. Bernstein
06c266bd8e Added TODOS directory. 2014-10-15 22:26:09 -04:00
Bradley M. Kuhn
be62a9b765 Investigate USA-specific-ness of "derivative work"
This FIXME is to remind me to look into this issue later.
2014-10-15 22:21:40 -04:00
Bradley M. Kuhn
2f2e5f9e4c Rework over-abundant use of term "derivative work"
The older portions of this tutorial tended to favor the term "derivative
work", since that was the popular catch-all term used at the time the
text was written.

However, as the newer text regarding GPLv3 now states, FSF abandoned the
use of the term "derivative work" in the text of GPLv3 itself, for
various reasons we already discuss in the tutorial.

Therefore, the tutorial text itself should likely not rely so heavily on
the phrase "derivative work" throughout.  This change herein reworks a
number of places where "derivative work" was used in the tutorial and
replaced it with other terms.

Ultimately, some word-smithing happened as part of the process of doing
this patch.
2014-10-15 22:14:45 -04:00
Bradley M. Kuhn
2a111432b2 Update this situation status.
This situation is still unresolved, but it's not necessarily accurate to
say that negotiations continue per se, since the issue in question is
now widely known by the entire Free Software community and remains an
issue.  (It should be obvious to the careful and informed observer what
situation this is.)
2014-10-15 19:11:15 -04:00
Bradley M. Kuhn
0f28185635 Wordsmith this sentence fragment a bit. 2014-10-15 19:03:50 -04:00
Bradley M. Kuhn
3d402b8cbf derivative works matter less than you think.
Given the wealth of text this chapter offers regarding derivative works,
this section really is necessary to give context on this point and
assure that the reader is not unduly swayed to believe that the
derivative work discussion is a central tenant of understanding
copyleft.

Long term, it may make sense to move the entire chapter on derivative
works to a different part of the tutorial.  Historically, it was placed
here because when teaching courses on the subject based on this text, I
found as an instructor that questions about derivative works became so
rampant from students during discussions of GPLv2§2 / GPLv3§5 that
derivative works discussion ahead of time was the only way to quell the
onslaught of ultimately off-topic questions.

Thus, the placement of the derivative works section in this location may
in fact be merely an historical artifact that this text was written
originally to accompany an in-course presentation.  While I'd still
recommend organizing a classroom presentation of these topics in that
order, I no longer believe the written materials must follow suit.
2014-10-15 18:53:32 -04:00
Bradley M. Kuhn
090b056608 Formatting typo fix. 2014-09-19 18:24:43 -04:00
Bradley M. Kuhn
012aebd493 Move details of exclusive power to a footnote.
enyst was quite correct that more explanation was needed here about how
an entity achieves exclusive relicensing rights.  However, the details
are somewhat off-point to what the section is trying to explain, so the
details are best placed in a footnote.

I've also separated out copyright assignment from generating all of
one's own copyrights.  This may be a distinction without a difference,
but a laundry list seemed appropriate here.  Perhaps this should be
shortened in future.
2014-09-19 18:16:02 -04:00
enyst
831c21febb Strictly speaking, for proprietary relicensing 'only' unconditional permissions are needed.
Signed-off-by: enyst <engel.nyst@gmail.com>
2014-09-19 18:09:46 -04:00
enyst
f31235afbc Possible fixes for incomplete or unclear phrases
Signed-off-by: enyst <engel.nyst@gmail.com>
2014-09-19 18:09:45 -04:00
enyst
d638f60cd9 Fixes for typos
Signed-off-by: enyst <engel.nyst@gmail.com>
2014-09-19 18:09:45 -04:00
Bradley M. Kuhn
8870e9097d The word former just belabored this sentence. 2014-09-19 18:02:08 -04:00
Bradley M. Kuhn
b7bb47188f Explain GPLv2 implicit private modification rights
I've long been aware that GPLv2 "technically" governed private
modifications and that generally there were probably more requirements
on privately modified versions of GPLv2'd works than most people assumed
in practice, including commonly held public interpretation by FSF.

HT Wolvereness, who pointed out to me that GPLv3 solved that problem.
When I spoke to Fontana about it, he was indeed aware that this text was
"missing" in GPLv2 and that GPLv3 properly added it, through some
politics during the GPLv3 process.

I've added herein the ultimate historical conclusions about GPLv2's
interpretation and how GPLv3 clarified it.  I've left out the color
about the politics of how it got added, not because they are not
interesting, relevant and germane to tutorial, but because we don't have
a good place yet in the tutorial for discussion of GPLv3 drafting
politics, and frankly if we have such a section, Fontana ought to write
it, not me.
2014-09-19 17:57:52 -04:00
Bradley M. Kuhn
3847ee1c1b Add label for this section. 2014-09-19 17:57:44 -04:00
Bradley M. Kuhn
d982de460a GPLv2§2 is for *distributing* modified versions.
This text needs to be clear that GPLv2§2 doesn't govern merely the act
of modification, but distributing modified versions (in whole or in
part).  The previous text here wasn't clear on that point.
2014-09-19 17:41:00 -04:00
Bradley M. Kuhn
e5ee0fd0a1 GPLv3 clarifies private modification permission.
While both GPLv2 and GPLv3 have long been considered to grant unabridged
right to private modification, GPLv3 has much clearer and explicit
wording to this effect.

This should be noted when that paragraph is explained.  This change
herein does that.

HT Wolvereness for pointing this difference between GPLv2 and GPLv3 out
to me.
2014-09-19 17:36:03 -04:00
Bradley M. Kuhn
558297c9c1 Shorten this sentence a bit. 2014-09-17 18:35:05 -04:00
Bradley M. Kuhn
3e638118b8 Rework these two paragraphs.
As previously written, these two paragraphs were saying very little with
a lot of words.  I've attempted to rework it a bit.
2014-09-17 18:31:43 -04:00
Bradley M. Kuhn
20361c3263 I don't think that While, belonged there anymore. 2014-09-17 18:25:46 -04:00
Bradley M. Kuhn
7d7f1ff75d Reword to simpler text in this sentence. 2014-09-17 18:25:22 -04:00
Bradley M. Kuhn
4b49be8441 Create a README.md file. 2014-09-05 16:00:28 -04:00
Bradley M. Kuhn
b5b0e2403e Opposite meaning was what was desired here.
HT Bob Hogg for discovering this error.
2014-08-12 08:12:49 -04:00