Commit graph

817 commits

Author SHA1 Message Date
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
Bradley M. Kuhn
19c75b012c Link to sponsors. 2014-12-02 20:49:50 -05:00
Bradley M. Kuhn
251bcc6947 Typo fix. 2014-12-02 20:48:42 -05:00
Bradley M. Kuhn
30e4942891 Reword paragraph; Include ref: "standard requests"
Mostly these changes are wordsmith, but I added a note that violators
should ask for the "standard requests" for compliance to be adequate.
2014-11-19 12:56:28 -05:00
Bradley M. Kuhn
b9f7a402a6 Rewrite paragraph for readability. 2014-11-19 12:53:29 -05:00
Bradley M. Kuhn
39ead95e9b Rewrite paragraph to fix better with section.
This paragraph was from text brought through from another document, and
as such, while this section was built "around it", the text itself was
stylistically different and otherwise problematic.  This change brings
it into form with the rest of the document.
2014-11-19 12:48:45 -05:00
Bradley M. Kuhn
3e88116a43 Small grammar fix. 2014-11-19 12:46:15 -05:00
Martin Michlmayr
cbfa27466e Update references to gitorious repo 2014-11-16 11:10:38 -05:00
Mike Linksvayer
5ffc615320 Reword mind-reading statements.
Merge requested proposed by @mlinksva has been changed slightly by
@bkuhn because there were changes to the README.md file since the
merge request was submitted that made some of the changes moot.
2014-11-16 11:01:54 -05:00
Bradley M. Kuhn
b920a7a4b8 Change links to copyleft.org site (now it exists) 2014-11-16 10:55:46 -05:00
Mike Linksvayer
312718cda0 it's is 2014-11-16 10:38:12 -05:00
Mike Linksvayer
a5fa6ca556 2 paras in a row start with However, 2014-11-16 10:38:12 -05:00
Mike Linksvayer
b35e89a8d8 more powerful interest*s* implicitly allied 2014-11-16 10:38:11 -05:00
Mike Linksvayer
a867743eb3 para prohibit*s* anyone 2014-11-16 10:38:11 -05:00