## Who Is In Charge?

Currently, [Bradley M. Kuhn](http://ebb.org/bkuhn/) is the editor-in-chief of

this Guide project.  However, many other contributors have given patches and

improvements to the text.  Review the

for more details on who has contributed to the project.

## How Do I Get Involved?

The Guide is maintained in a copylefted distributed version control system called

See the section "Merge Request and Patch Workflow" below for more information

on the details of doing that.

However, lack of Git and/or LaTeX knowledge is *not a barrier* for

contribution to this project.  Useful contributions will be accepted by the

following means as well:

   included because those parts aren't appropriate for the Guide).

   This procedure creates a "commit point" that shows the specific text

   brought from the other source — more-or-less as it stood in the

   other work.  This is useful for historical archiving purposes.

   contains an example of this specific procedure.

2. In a second commit, by itself, add the following two things only:

      * Update the copyright notices found in

        [comprehensive-gpl-guide.tex](comprehensive-gpl-guide.tex).  Ensure

   Ideally, all copyleft advocates would agree on all points, but they don't.

   Therefore, the Guide should note the major differences in opinion in the

   actual text, and include footnotes for any notable minority opinions.

   Commit changes as necessary, in the smallest increments reasonably

   possible.

   is an example of the process for the last two steps.

5. Submit a merge request for your branch into 'next'.  In this particular

   situation, it's particularly helpful to make a formal merge request on

   Gitorious rather than emailing a patch set.

## Merge Request and Patch Workflow

Currently, the main location for work on this project is

development on the project happens on the

(which is

[auto-published on the copyleft.org/guide-next URL](https://copyleft.org/guide-next/)).

Here is a suggested workflow for submitting patches — first doing so

*with* the Gitorious infrastructure, second *avoiding* the Gitorious

infrastructure but still using Git, and third avoiding Git altogether.

Merge requests and/or patches against

typically much preferred, and the workflow explanations below assume that.

However, merge requests and/or patches against

are not necessarily rejected.  In fact, if your change is a fix for typo,

spelling, grammar, formatting or anything urgent, submitting a patch against

'master' may make more sense.

To use the instructions below for proposals against the 'master' branch, just

replace 'next' everywhere below with 'master'.

First-time contributors may want to do the following four items first:

    Instead of the default, you might call your clone

2. On the command line create a *local* clone of your Clone, by typing:

    (The last part isn't strictly necessary; you just might want to name the

    upstream repository a more descriptive name, since below you'll add the

    official repository as well).

3. Now, add to your clone a copy of the "real" copyleft.org tutorial

   repository, and make a branch that tracks the official version:

That completes the first-time setup.  Next is a workflow each proposed merge

request.

0. First, ensure the Git repository points at the right branch and all old

   changes are committed.

   some other situation, which is beyond the scope of this document.

1. Now, get the most recent version of the 'next' branch:

        $ git checkout master

        $ git branch -D official-next

        $ git checkout official-next

        $ git pull

   (This step is more complicated than is typically found in a tutorial like

   this.  Experienced Git users will note the above is the easiest way to

   handle the fact that the 'next' branch is occasionally rebased against

        $ git status

        # On branch my-new-idea-for-tutorial

        nothing to commit (working directory clean)

4. Next, upload and publish those ideas to your own clone on Gitorious.

    That's the end of the command-line part.

   Initiate your merge request with by setting:

6. While it's possible to discuss the details of the merge request via the

   web interface, for larger changes, it may be worthwhile to start a thread

   on

   [the mailing list](http://lists.copyleft.org/cgi-bin/mailman/listinfo/discuss)

   about the merge request.  Include the URL of the merge request in the

You may also

[browse the current version of the guide on copyleft.org](https://copyleft.org/guide/),

and [download a PDF of the Guide as well](http://copyleft.org/guide/comprehensive-gpl-guide.pdf).

Note the

purposes only.

## Contributing

Improvements of all kinds and manner are welcome.  Please review

[the instructions and details regarding making contributions](CONTRIBUTING.md)

$ make

\end{lstlisting}

and waited approximately 40 minutes for the build to complete\footnote{Build

  times will likely vary widely on various host systems.}.  The investigator

kept a

  log of the build}, which is not included herein due its size (approximately

7.2K of text).

\label{thinkpenguin-main-build}

Upon completion of the ``make'' process, the investigator immediately found

(almost to his surprise) several large firmware files in the ``bin/ar71xx''

mips-librecmc-linux-uclibc-gcc.bin: /lib/libc.so.6:

   version `GLIBC`_2.14' not found

   (required by mips-librecmc-linux-uclibc-gcc.bin)

\end{lstlisting}

   (The

  log output from the failure} is too lengthy to include herein.)

   This issue is an annoyance, not a compliance problem.  It was clear from

   context that these binaries were simply for a different host architecture, and

   the investigator simply removed ``toolchain/bin'' and created a symlink to

   utilize the toolchain already built earlier (during the compilation

   After this change, the U-Boot build completed successfully.

\end{itemize}

The

  log of the build} is not included herein due its size (approximately 3.8K

of text).  After that, the investigator found a new U-Boot image in the

``bin'' directory.

\section{Root Filesystem and Kernel Installation}

firmware image with the filesystem originally found on the device itself.

The comparison steps were as follows:

\begin{enumerate}

\item Extract the filesystem from the image we built by running

  on ``bin/ar71xx/librecmc-ar71xx-generic-tl-wr841n-v8-squashfs-factory.bin''

  and then running

  \href{http://www.binaryanalysis.org/en/content/show/download}{bat-extratools}'

  ``squashfs4.2/squashfs-tools/bat-unsquashfs42'' on the resulting

  morx0.squash, using the filesystem in the new squashfs-root directory for

  comparison.

\chapter{Citations of Incorporated Material from Other Published Works}

As a public, collaborative project, this Guide is primarily composed of the

many contributions received via its

\href{https://gitorious.org/copyleft-org/tutorial/source/master:CONTRIBUTING.md}{public

  contribution process}.  Please

  Git logs} for full documentation of all contributions.

Below is a list of CC-By-SA-licensed works, with specific titles and

publication dates, from which any material was incorporated into this Guide.

The specific methods and details of incorporation are fully

documented in the

of the project.

\label{third-party-citation-list}

\begin{itemize}

\item \hrefnofollow{http://gplv3.fsf.org/gpl-rationale-2006-01-16.html}{\textit{GPLv3 First Discussion Draft Rationale}}, published by the Free

 Software Foundation on 2006-01-16.

Please note, however, that this list above does not include nor adequately

represent the substantial contributions from those who directly

contributed to this Guide using its Git (and formerly, CVS) repository.

Rather, this is a list of third-party published works from which any text was

herein included under their CC-By-SA licensing.  Thus, as the reader might

expect, the

  control logs} contain the only true and accurate view available of who has

contributed which portions of this project.