Commit graph

47 commits

Author SHA1 Message Date
Bradley M. Kuhn
2a42c6fb7e FIXME describing what introduction should say.
We need an introduction, particularly if we merge the CC-BY-SA material
that @mlinksva provided.
2014-12-23 13:37:25 -05:00
Bradley M. Kuhn
04a38b87ec Order matters in \usepackage{hyperref}.
The problem exhibited only in PDF files, wherein \ref{} links to
appendix chapters referred instead to regular chapters.

http://tex.stackexchange.com/questions/77886/fncychap-and-hyperref-messes-up-page-references
suggest that loading hyperref second fixes the problem.  This indeed
worked.
2014-12-22 21:09:04 -05:00
Mike Linksvayer
f4fd426471 consistent capitalization of verbs, no reason to copy capitalization within CC-BY-SA or any other license 2014-12-22 14:56:37 -08:00
Bradley M. Kuhn
79c5b890eb Consolidate copyright notices into single place.
Historically, this project used (more-or-less) a file-by-file copyright
inventory.  This commit ends that practice.  The project now has a
single toplevel copyright inventory, stored exclusively in
comprehensive-gpl-guide.tex (so that it appears also in compiled
versions of the Guide as well).

The side-effect of this commit is that the parts may no longer be easily
publishable separably without (at least) the additional work of
copyright notice reconstruction.  This may in particular create a
challenge for the FSF, who has historically selectively published
sections of this Guide as materials for its CLE classes.

However, without this change, this Guide will eventually suffer from the
inherent problems in maintaining file-by-file copyright inventory.
Circumstances simply dictate a single, top-level copyright and license
notice for the entire Guide.

In addition to consolidation of copyright notices, I've also herein
updated my historical copyright notices to properly credit me for my own
work done in 2003 through 2005.

I've also updated the license notice to reflect the changes made by the
previous commit and related issues.
2014-12-22 17:22:50 -05:00
Bradley M. Kuhn
ce9168a9af Citations of third-party works in appendix only.
As alluded to in 2ea19b71d4 's commit
message on 2014-12-17 19:52:15 -0500, keeping any information on a
part-by-part basis is difficult and error-prone, since there exists no
reliable way to auto-generate such information accurately.

Therefore, citations to third-party works, in addition to remaining
fully documented in the commit log as they always have been, are now
placed in specifically one location in the body of the text itself: a
single appendix specifically designed for that purpose.

In this manner, contributors have no house-keeping work regarding
citations.  Contributors need only list third party works and links in
one place: third-party-citations.tex.

Documentation in CONTRIBUTING.md for making contributions of third-party
works is left as a TODO.
2014-12-22 16:30:00 -05:00
Bradley M. Kuhn
b75c05d7bb Provide additional href link command.
Add additional command that can be used in place of href where
appropriate.
2014-12-17 23:11:56 -05:00
Mike Linksvayer
e8873823aa 'not an equivalent for' should be either 'not a substitute for' or 'not equivalent to' 2014-11-16 10:32:41 -05:00
Bradley M. Kuhn
ab40337b50 Correct URL: s/gpl-compliance-tools/copyleft-org/
The name of the Gitorious project was renamed at the launch of
copyleft.org.  Therefore, the former URL is no longer valid.
2014-11-13 13:32:29 -05:00
Bradley M. Kuhn
2c0d78bdae Merge 'master' into current 'next' branch.
There was one minor change to the title page on master that isn't
represented on 'next'.  While I could have rebased, I chose to merge so
I didn't have delete the publicly published 'next' branch on gitorious
like I have to do when I rebase.
2014-11-13 13:10:12 -05:00
Bradley M. Kuhn
b71951bbaa Link to copyleft.org on title page.
Often, the PDF file is separated fully from copyleft and distributed.
As such, the title page should not only include a link to the sources
for patches, but also for the main copyleft.org site for the Guide.
2014-11-13 11:15:09 -05:00
Bradley M. Kuhn
345da0fc2e Integrate pasted & commented out text for GPLv3§7.
The pasted text, most of which was useful, is now integrated as the
desired laundry-list of GPLv3§7 subsection explanations.

This also allowed for easy integration of some of the older
commented-out text that originally came from GPLv3 rationale documents.

Meanwhile, however, I discovered, upon more careful examination of the
pasted text, a serious and grave error regarding GPLv3§7(d).
Specifically, GPLv3§7(d) makes the modern "third clause" of the 3-Clause
BSD compatible with the GPL, *not* the problematic old-school BSD
advertising clause (from the 4-Clause BSD).

I'm amazed that anyone versed in licensing could make this error,
frankly, and readers should be told, since other materials are now
disseminated by others, that the point is incorrect.  Therefore, I've
not only noted the correct compatibility conclusion, but also
affirmatively identified the incorrectness of the wrong conclusion that
was previously added via the pasted text from SFLC's "Guide".

Finally, on a LaTeX formatting note, the enumitem package is now needed
since I'm using that for the list of GPLv3§7 subsections.
2014-11-13 10:32:54 -05:00
Bradley M. Kuhn
851be52e62 Rework two compliance guide sections in Background
Some of the text pasted in earlier commits was certainly useful, but
needed a complete rework.

Also, the text pasted was far too terse, and more detail was needed.

Therefore, I've moved text around and build a more comprehensive
Background section.  I've moved the burgeoning "Understanding Who's
Enforcing" section into the Background chapter and made it complete.

Probably the most bizarre (?) change I've made here is coining this
acronym COGEO.  This is non-optimal for sure, and I've added a FIXME to
seek a better term.
2014-11-10 18:56:14 -05:00
Bradley M. Kuhn
a1b059184c Incorporate useful text from a third party work.
Software Freedom Law Center, a small law firm specializing in Open
Source, recently published its so-called "Guide to GPL Compliance,
Second Edition":
http://softwarefreedom.org/resources/2014/SFLC-Guide_to_GPL_Compliance_2d_ed.html

The Firm's document is substantially less comprehensive than this one;
however, their document contained a few phrases and paragraphs that
seemed useful and accurate.  This commit incorporates the useful
material from that work into this one (as permitted by the CC BY-SA 4.0
license, which the Software Freedom Law Center applied to their work).

The useful sections have been pasted without proper textual integration
into the appropriate sections of this tutorial.  A few are currently
commented out entirely and marked with appropriate FIXME's.  Meanwhile,
the text that seems immediately useful is *not* commented out, and is
marked with "FIXME-URGENT".  Additional work is now required to
integrate the new text properly into this tutorial.

Careful readers who compare this commit with The Firm's document will
find that I passed on inclusion of some seemingly useful material.
Unfortunately, The Firm's text contained some inaccuracies, and frames
discussion primarily from a for-profit perspective.  More disturbingly,
a few statements even directly contradicted the FSF's stated policies.
Of course, The Firm clearly claims "this document does not express the
views, intentions, policy, or legal analysis of any SFLC clients or
client organizations", but I could not in good conscience adopt, as the
official advice in this tutorial, any text that conflicts with the FSF's
policies, nor will I incorporate any puffery that subtly kowtows to
for-profit corporate interests.

Nevertheless, given The Firm's perceived stature, I briefly considered
including policy-conflicting statements, attributing them as alternative
third-party opinions; many of the FSF's own opinions were already
incorporated in that manner earlier this year.  Indeed, I will not prima
facie reject future patches that integrate such statements naturally for
this tutorial.  However, I feel that the didactic value of including The
Firm's attributed dissenting opinions in this tutorial does not outweigh
my editing effort required for such additional textual integration.

Regarding Software Freedom Law Center's copyrights included herein,
I took the following specific actions to comply with CC By SA 4.0:

§3(a)(1)(a)(i):    This log message indicates Software Freedom Law Center
                   as the source of the material herein committed.

§3(a)(1)(a)(i):    Copyright notices at the top level of the document,
                   as well as those in individual parts, are updated to
                   include the 2014 copyright notice from the Software
                   Freedom Law Center.

§3(a)(1)(a)(ii-v): The project already referred to and included a copy
§3(b)(1):          of CC BY SA 4.0 International and its URL.

§3(a)(2):          The attribution information is fully included in
                   this Git repository.

§3(a)(3):          I and this project have received no such request.

§3(b)(1):          The license of the larger work was already
                   CC BY SA 4.0 International.

§3(b)(3):          No such conditions are imposed.
2014-11-10 16:21:53 -05:00
Bradley M. Kuhn
99fccc120c PDF output doesn't have enough space here. 2014-11-09 16:11:45 -05:00
Bradley M. Kuhn
54f94ca0a9 FIXME regarding inconsistent code example formats 2014-11-09 14:07:02 -05:00
Bradley M. Kuhn
3ee46d6770 A few FIXMEs for formatting hacks. 2014-11-09 12:20:32 -05:00
Bradley M. Kuhn
a45f702c2a Formatting fixes for copyright notices. 2014-11-09 11:25:45 -05:00
Bradley M. Kuhn
cd7143d917 Correct grammar errors in appendix license info. 2014-11-09 05:51:28 -05:00
Bradley M. Kuhn
3a5872fab3 Properly format and place title everywhere.
This was working more or less before, but during hasty changes last
night, I seem to have reverted it.  I just tested this and it seems to
put titles in the right places.
2014-11-07 11:35:13 -05:00
Bradley M. Kuhn
31220d4762 Discussion of included README & its lesson learned
Included also is a code listing of mounting the iso, and the like, which
required use of a new LaTeX package.
2014-11-07 08:39:24 -05:00
Bradley M. Kuhn
53a64ca4a1 Ensure that title appears properly. 2014-11-07 00:51:54 -05:00
Bradley M. Kuhn
b46d1bc16f Correction to formatting on copyright notices. 2014-11-06 21:30:53 -05:00
Bradley M. Kuhn
467a23152a Copyright notice updates.
Joshua Gay made contributions to all the files earlier in 2014 (see git
log) which were copyrighted by the FSF, so FSF's copyright needs
refreshed to include this year.

Denver recently added a section to the enforcement-case-studies.tex, so
his copyright notice needs to go there and at the top file.

I made changes to enforcement-case-studies.tex on top of Denver's.

Also, remove commented-out copyright notices -- the ones in the actual
text are now primary and should be maintained directly.
2014-11-06 16:59:48 -05:00
Bradley M. Kuhn
aab19d9e4c Use \url here instead of \verb0URL0 2014-11-06 16:04:45 -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
05d02bfff4 Various temp changes to handle printing it this weekend. 2014-03-20 22:01:07 -04:00
Bradley M. Kuhn
077622c177 Note that sources are available. 2014-03-20 21:44:56 -04:00
Donald Robertson, III
a8b25085c2 changed modified GPL note to say explanation instead of additional permission 2014-03-20 12:52:39 -04:00
Bradley M. Kuhn
ee9e86642a Properly update and format copyright notices and title pages. 2014-03-20 09:59:16 -04:00
Tony Sebro
844bf4ba5b Updated analysis of derivative works. 2014-03-19 12:17:14 -04:00
Bradley M. Kuhn
4cea1c4645 Relevant text from GPLv3 First Discussion Draft Rationale of 2006-01-16.
I carefully went through FSF's First Discussion Draft Rationale, which was
published on Monday 16 January 2006 and merged in any relevant text and
descriptions that might be of use in this tutorial.

The raw material used for this commit can be found here:
       http://gplv3.fsf.org/gpl-rationale-2006-01-16.html
Specifically, a copy of the LaTeX sources are here:
       http://gplv3.fsf.org/gpl-rationale-2006-01-16.tex

As I merged in this text, I added FIXME's where it seemed the text was
incomplete or referred to parts of GPLv3 draft text that disappeared in later
versions.

Finally, note that this material was originally copyrighted and licensed as
follows:

  Copyright © 2006 Free Software Foundation, Inc.

  Verbatim copying and distribution of this entire article are permitted
  worldwide, without royalty, in any medium, provided this notice, and the
  copyright notice, are preserved.

However, I am hereby relicensing this material to CC-By-SA-4.0, with the
verbal permission from John Sullivan, Executive Director of the FSF, which
was given to me during a conference call on Wednesday 12 February 2014.
2014-03-19 09:44:59 -04:00
Bradley M. Kuhn
a700a8caa6 I'm starting to think Conny looks better.
Long term, as mentioned in a previous commit, we should look at the memoir
package.
2014-03-16 16:24:44 -04:00
Bradley M. Kuhn
76284eab94 new command for when tutorials are split apart.
First arg is what to say when it's by itself, second arg is for when they are
integrated.
2014-03-16 16:21:58 -04:00
Bradley M. Kuhn
dd4bec31c0 Notes about formatting and possible later use of memoir, fancyhdr for now. 2014-03-15 11:48:28 -04:00
Bradley M. Kuhn
e4dc938c8c Word smith. 2014-03-15 11:06:38 -04:00
Bradley M. Kuhn
33bfee7702 It's for lawyers too. 2014-03-15 11:06:33 -04:00
Bradley M. Kuhn
7ad226003d Create and update copyright notice and licensing information. 2014-02-20 13:37:39 -05:00
Bradley M. Kuhn
f54257ba65 Move stuff to make the ToC with now ...'s and numbers to another file,
and comment it out by default.
2014-02-20 13:37:23 -05:00
Bradley M. Kuhn
bf4b3db60b Incorporate enforcement case studies part into full book.
This required removing much of the seminar-specific content, and
reformatting.
2014-02-20 12:50:53 -05:00
Bradley M. Kuhn
9eb3c521b0 Incorporate the compliance guide into main text of the book.
This required resectioning the entire compliance guide to be 'one level up'.
It furthermore required a few other formatting and related changes.
2014-02-20 12:46:33 -05:00
Bradley M. Kuhn
16ffbf69c5 Correct licensing information so that it properly mentions licensing of licenses. 2014-02-20 12:39:24 -05:00
Bradley M. Kuhn
f5c0cdc919 Remove license text appendix from gpl-lgpl.tex and place it in its own file.
Really, all these license texts should go at the very end behind all other
materials.
2014-02-20 12:26:52 -05:00
Bradley M. Kuhn
52962a2af7 Temporarily added this code to generate a ToC without page numbers.
I doubt this will be kept permanently.

I learned this from:
http://tex.stackexchange.com/questions/55465/remove-dots-page-numbers-from-toc
2014-02-20 10:55:51 -05:00
Bradley M. Kuhn
2230849e93 Move table of contents before the Preface. 2014-02-20 10:55:18 -05:00
Bradley M. Kuhn
4331138536 Get one inch margins all around. 2014-02-20 10:46:57 -05:00
Bradley M. Kuhn
5b8a5bac11 Better title, and reformat title for title page. 2014-02-20 10:46:44 -05:00
Bradley M. Kuhn
1583f593ca Initial work to merge this into a single comprehensive book.
This entails removing book-like parts of gpl-lgpl.tex, moving some of it into
this new toplevel file, and some other formatting and related changes.
2014-02-20 10:33:16 -05:00