Merge pull request #2356 from freifunk-gluon/doc-make-update

This commit is contained in:
Martin Weinelt 2021-12-31 03:01:45 +01:00 committed by GitHub
commit 65da23ada4
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 13 additions and 2 deletions

View File

@ -23,6 +23,7 @@ webbrowser. You're welcome to join us!
.. _hackint: https://hackint.org/ .. _hackint: https://hackint.org/
.. _webchat: https://webirc.hackint.org/#irc://irc.hackint.org/#gluon .. _webchat: https://webirc.hackint.org/#irc://irc.hackint.org/#gluon
.. _working-with-repositories:
Working with repositories Working with repositories
------------------------- -------------------------

View File

@ -86,10 +86,10 @@ Extensive documentation about the site configuration can be found at:
site directory should always be a git repository by itself; committing site-specific files site directory should always be a git repository by itself; committing site-specific files
to the Gluon main repository should be avoided, as it will make updates more complicated. to the Gluon main repository should be avoided, as it will make updates more complicated.
Next go back to the top-level Gluon directory and build Gluon:: Next go back to the top-level Gluon directory and build Gluon\ [#make_update]_::
cd .. cd ..
make update # Get other repositories used by Gluon make update # Get other repositories used by Gluon
make GLUON_TARGET=ath79-generic # Build Gluon make GLUON_TARGET=ath79-generic # Build Gluon
In case of errors read the messages carefully and try to fix the stated issues In case of errors read the messages carefully and try to fix the stated issues
@ -125,6 +125,16 @@ These can be used for debugging and should be stored along with the images to
allow debugging of kernel problems on devices in the field. allow debugging of kernel problems on devices in the field.
See :ref:`Debugging <dev-debugging-kernel-oops>` for more information. See :ref:`Debugging <dev-debugging-kernel-oops>` for more information.
.. rubric:: Footnotes
.. [#make_update] ``make update`` only needs to be called again after updating the
Gluon repository (using ``git pull`` or similar) or after changing branches,
not for each build. Running it more often than necessary is undesirable, as
the update will take some time, and may undo manual modifications of the
external repositories while developing on Gluon.
See :ref:`working-with-repositories` for more information.
Cleaning the build tree Cleaning the build tree
....................... .......................