Commit graph

830 commits

Author SHA1 Message Date
Bradley M. Kuhn
40fa2e6685 Clarify who "most people" meant, drop UCITA ref.
The intent of this text was to point out that most users don't actually
believe they get warranties, which is still surely correct, given that
GPL disclaims warranties in the same manner nearly every software
license -- proprietary or free -- does anyway.

Also, the forward-reference to the later section's discussion of UCC
should be hinted at here.  There is no explicit reference to UCC made
here, but it is encompassed in "many local laws", since the later
section mentions the specific section of UCC involved.

Meanwhile, the reference to UCITA is dropped, but perhaps it should be
reintroduced in other text in the main warranty section.  UCITA has had
much less policy impact than was expected when the original version of
this text was written.  It might be useful to ask policy folks and
attorneys from Maryland and Virginia who might be able to help explain
what impact UCITA has had being on the books only there.
2015-03-13 09:58:02 -07:00
Bradley M. Kuhn
555a72beb1 Suggestions for in depth discussion of GPLv2§2(a)
GPLv2§2(a) is mentioned quite cursorily.  Olly Betts suggests more
coverage here might useful on IRC.  I noted some ideas after he
suggested it.
2015-03-12 17:15:15 -07:00
Bradley M. Kuhn
ec2abce021 Rework text to introduce definition of CCS.
CCS ultimately wasn't mentioned until much later in the GPLv3 sections,
where, ironically, we have to point out that GPLv3 defined the term as
"Corresponding Source" [0], not CCS, and explain why GPL enforcement
wonks still say CCS.

This rework now introduces the acronym at the natural moment: while
describing GPLv2§3's use of the words "complete" and "corresponding".

Adding that made the section even more disjoint than it already was.  I
put in some \subsection's to make it slightly less so, and did some
wordsmith work on surrounding text.

[0] I wish some GPLv3 drafter had asked me what to call the defined term
     so that I could point out what fit standard parlance. :)
2015-03-09 22:33:52 -07:00
Bradley M. Kuhn
15ae6f3a17 Wordsmith this tortured text. 2015-03-09 19:05:18 -07:00
Bradley M. Kuhn
dca1aa0115 "by definition" is clearer here than "by default"
There's probably another phrase we could use that's even better.
2015-03-09 19:03:53 -07:00
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
0adba83923 FIXME re: "dynamic linking delayed" to runtime.
The existing text of the Guide hints at this point but doesn't discuss
it directly.  This FIXME is merely a reminder note to investigate this
issue in further detail and perhaps add text here on the question.
2014-12-23 13:22:05 -05:00
Bradley M. Kuhn
eab5efb42b Null character needed at end of a LaTeX sentence. 2014-12-23 13:15:46 -05:00
Bradley M. Kuhn
0e49270eb1 Contributing text from third-party works.
Integration of text from third-party works is complicated, since the
text must be incorporated to flow properly with the rest of the Guide.
Also, historical archiving commits are particularly useful in such
situations.  This tutorial explains how to contribute such additions for
this project.
2014-12-22 21:16:33 -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
27739cd92e copyleft.org tutorial, not conservancy policies 2014-12-22 19:18:23 -05:00
Mike Linksvayer
ce1c96a1a1 Make attributions consistent.
Also, fix a few spurious characters.
2014-12-22 19:13:48 -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
1da1b24a14 Wordsmith sentence after phrase "such software".
I think Fontana's change a few commits back which s/it/such software/ in
this sentence is a useful one.  However, the entire sentence reads even
worse because "such software Free Software" looks so strange as a string
of words in the middle of the sentence.

This change is the best rework I could find that resolved the problem.
It's probably not the best option but is certainly an improvement.
2014-12-20 20:04:56 -05:00
Bradley M. Kuhn
c5866203ee Replace editorial commentary w/ FSF's link.
My personal comment here, which I wrote on 2003-05-26 (see
f05ce6c657 ), is probably not particularly
useful.  I still tend to use the phrasing as original stated in the
removed text herein; however, I'm admittedly the only one.  I don't deny
that I hope to coin some terminology usage through my work on this
Guide, but this particular use of "nonfree software" to mean
"noncommercially proprietary" is not so important IMO that this Guide
must coin it.

The FSF's page on this doesn't make that distinction, and has much more
detail on this issue than this section does.  Therefore, the
personal statement is removed, and the organizational statement on the
FSF's site is instead linked to.
2014-12-20 20:04:56 -05:00
Richard Fontana
628ffb6020 Some editorial changes.
Commenting on one: the initial-caps stylistic preference for "Free
Software" (though it contradicts prevailing usage, including that of RMS
and the FSF) ought to be respected, but I think it is confusing to
capitalize the 'S' when referring to nonfree software as "non-Free
Software". So I changed this to "non-Free software" and also implicitly
acknowledged that the preference for "non-Free" over "nonfree" is the
editor-in-chief's stylistic idiosyncrasy.
2014-12-20 20:04:56 -05:00
Richard Fontana
170f507ac6 Some editorial changes. 2014-12-20 20:04:56 -05:00
Richard Fontana
dab88657a4 "GNU project" -> "GNU Project". 2014-12-20 20:04:56 -05:00
Richard Fontana
ff7790d608 "business people" -> "businesspeople" 2014-12-20 20:04:56 -05:00
Bradley M. Kuhn
cd25fdd2c9 Document work-around for 'next' branch rebases.
Upstream in the copyleft.org tutorial repository, the next branch is
sometimes rebased against the master branch.  (For example, this occurs
when there have been quick fixes done on 'master' while new drafting
occurs on 'next'.)

This procedure, while convoluted, is the best way I've found to
compensate for this problem.  Hosting sites like Gitorious really aren't
designed for rebased branches.
2014-12-20 19:34:05 -05:00
Bradley M. Kuhn
81157b3136 No instructions for 'master';just note possibility
Ultimately, users will probably pick either 'master' or 'next' to submit
changes anyway, so just leave the instructions to refer to 'next' and
note that they could replace 'next' with 'master'.
2014-12-20 19:31:57 -05:00
Bradley M. Kuhn
ea09b83e00 It's useful to post merge requests on mailing list 2014-12-20 19:31:57 -05:00
Bradley M. Kuhn
c830d8b51b Typo fixes. 2014-12-20 19:31:57 -05:00
Bradley M. Kuhn
fd2318650e Detailed merge request instructions for Gitorious.
Most Gitorious users know this procedure, but it seems useful to
document it in great detail here, since copyleft.org seeks contributions
from those who might be knew to Git, and those who are more familiar
with procedures of other collaboration sites.
2014-12-20 19:31:57 -05:00
Bradley M. Kuhn
57e8fa1cb2 Note merge request should usually target next.
Some targets to master are acceptable, though.
2014-12-20 19:31:57 -05:00
Bradley M. Kuhn
e1373883c9 More about the next branch. 2014-12-20 19:31:57 -05:00
Bradley M. Kuhn
6b441fa057 Note TODO list and lack of bugtracker. 2014-12-20 19:31:57 -05:00
Bradley M. Kuhn
756748a79b Wordsmith this text. 2014-12-20 19:31:57 -05:00
Bradley M. Kuhn
fd8fdee5bf Rewrite text to not sound so BDFL-ish. 2014-12-20 19:31:57 -05:00
Bradley M. Kuhn
b855c3f4ca Note that our tools are themselves copylefted. 2014-12-20 19:31:57 -05:00
Bradley M. Kuhn
d3baa07f5f CONTRIBUTING.md now canonical such information. 2014-12-20 19:31:57 -05:00
Bradley M. Kuhn
883e2078ec Logs have more than just committers. 2014-12-20 19:31:57 -05:00
Bradley M. Kuhn
8498c557d5 Correct title and formatting.
There was a typo in the title and a stray comma.
2014-12-20 19:31:56 -05:00
Bradley M. Kuhn
71c4a74974 Begin section on merge/patch workflow. 2014-12-20 19:31:56 -05:00
Bradley M. Kuhn
cacdffc192 First draft of CONTRIBUTING.md file. 2014-12-20 19:31:56 -05:00
Andrew Engelbrecht
daced43610 move long parenthetical text out of short sentence
it's easier to read this way.
2014-12-20 19:22:44 -05:00
Andrew Engelbrecht
5879dd3344 correct literal meaning of phrase
GPL protected code-bases don't demand industry trust, modern industry
trusts GPL protected code-bases.
2014-12-20 18:49:36 -05:00
Joshua Wells
07912cb5fc Fix broken link 2014-12-20 18:34:44 -05:00
Bradley M. Kuhn
1ed31baa28 Gerund use was incorrect grammar here. 2014-12-20 18:09:52 -05:00
Bradley M. Kuhn
b0801a2b8a Clarify sentence.
Make this sentence a bit clearer.
2014-12-19 19:09:01 -05:00
Bradley M. Kuhn
e01c6bf303 Remove spurious line.
This line was carried over as a paste from a previous version of the
paragraph above it, and is now no longer needed.
2014-12-17 23:34:50 -05:00
Bradley M. Kuhn
6a0567ac6f Make descriptions uniform.
Descriptions in this list should be uniformly worded.
2014-12-17 23:31:39 -05:00
Bradley M. Kuhn
48e517cb83 Additional published work.
This publish work was also referenced in the old commit logs already,
but now that we have a list in the work itself, it can also be listed
here.
2014-12-17 23:26:26 -05:00
Bradley M. Kuhn
bd80fd4703 List missing co-author on this published work.
Karen Sandler was co-author of the work herein referenced, and was
accidentally left off the list of authors in an earlier commit.
2014-12-17 23:24:59 -05:00
Bradley M. Kuhn
22fe0956db Add hyperlinks to remixed published works.
Now that a list of published works is part of the document proper, it is
reasonably practicable to add hyperlinks to those works.
2014-12-17 23:21:07 -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
Bradley M. Kuhn
2ea19b71d4 Remove incomplete lists of authors entirely.
The lists of authors in each part has been continually out of date and
incomplete.  There are multiple examples, here are a few:

  * In September 2005, John Sullivan made improvements and was not placed on
    the Authors lists until I did so in a March 2014 commit.

  * In March 2014, Martin Michlmayr submitted many patches, but was not
    placed on the Authors lists until I did so in an April 2014 commit.

There is no easy way to keep these Authors lists current, and they aren't
necessary under CC-BY-SA-4.0 anyway, so I herein remove the Authors lists.
Additionally, previous commit added "published sources" in each part, which
is more static and easier to keep up to date and provides similar
information.
2014-12-17 19:52:15 -05:00
Bradley M. Kuhn
3605394f30 List published works & link to Git logs.
References and details regarding these published works from which some
text was incorporated already appeared in the commit logs in great
detail.  The information, already fully available in the Guide's Git
logs in full compliance with CC-BY-SA-4.0 §3(a)(1-2), now appears in
summary form additionally in the compiled PDF/HTML/Postscript output.
2014-12-17 18:33:10 -05:00