summaryrefslogtreecommitdiff
path: root/manpages/en
AgeCommit message (Collapse)Author
2020-04-29manpages: tiny clarifications and tweaksLyndon Brown
not worth listing the specifics mostly the following though: - "(comma or space separated)" -> "(a comma or space separated list)" - quoting values Gbp-Dch: Ignore
2020-04-29manpages: fix formatting mistakesLyndon Brown
shortoptions also emboldened Gbp-Dch: Ignore
2020-04-29manpages: tiny correctionLyndon Brown
"all (applicable)" -> "all" this needed adjusting after 38a5aed0dcdf71f43cecfadc6e34c659408b6a00 don't want to confuse users Gbp-Dch: Ignore
2020-04-29manpages: fix typosLyndon Brown
"whould" -> "would" "build" -> "built" Gbp-Dch: Ignore
2020-04-29manpages: fix typoLyndon Brown
"bugreport" -> "bug report" i won't bother changing the dates just for this one. Gbp-Dch: Ignore
2020-04-25manpages: fix typoLyndon Brown
"Sor" -> "So" Gbp-Dch: Ignore
2020-04-23config: revert partial format conversionLyndon Brown
back in v4.0~a6-1 a transition process was started to move the live-build config to a new format. the new format was INI style, and required parsing functions to read/write values, compared to the existing format which was just shell script code setting variables. this partial transition is the explanation for the existence of the `New_configuration()` function, and understanding this is important to understanding the purpose of it - it is not in fact intended for creating a new configuration, it is just related to the new config format transition. the positives of the new format were that it was somewhat cleaner looking, while the negative was the terrible relative efficiency. the file `config/build` was created to hold options in this new format. the transition was only ever completed for a handful of config options: - architecture - archive areas and parent archive areas - live image name - live image type a 'configuration version' attribute was also saved, which is not used by anything. the bootstrap-mirror and parent-bootstrap-mirror attributes are pointlessly stored in it seemingly resulting from work done in v4.0~a17-1. (they are also stored in another config file from which the value is actually used). it in fact seems to have been a source of confusion for Raphaël in authoring 44b9b0a6501476de594ce3783cea5df0c141478c, since the new `[parent]-distribution-{chroot|binary}` options it introduced were stored both in `config/bootstrap` and in `config/build`, while only used from the former. i expect, understandably, that he thought that `config/build` was just an information file. Gbp-Dch: Short
2020-04-23config: obsolete old --tasksel optionLyndon Brown
note that the bit of code removed from source_debian relies upon a variable LB_TASKS which itself is an old leftover artefact from before v4.0. Gbp-Dch: Short
2020-04-23manpage: fix typo and simplify --net-tarball option descriptionLyndon Brown
2020-04-23config: obsolete --net-root-pathRaphaël Hertzog
2020-04-23config: obsolete --net-root-* options (except one)Lyndon Brown
--net-root-path probably needs to go too, but it is being used for something i don't fully understand currently. Gbp-Dch: Short
2020-04-23config: obsolete unused --net-cow-* optionsLyndon Brown
2020-04-23config: obsolete unused --isohybrid-options optionLyndon Brown
2020-04-23config: apt-get should probably be an allowed and documented --apt valueLyndon Brown
since everywhere where 'apt' is a permitted value, 'apt-get' is also, it just wasn't listed in the option's documentation and thus was also not listed in the new validation check. Gbp-Dch: Short
2020-04-23config: add --validate optionLyndon Brown
running `lb config --validate` causes the script to stop after running the validation check on the config compiled at that point, prior to writing the config to disk. this gives users the ability to check the validity of a config without modifying or rewriting the saved config. note that if users provide new config options alongside --validate, these are taken into account in the check performed. the 'check complete' message will not be seen if an error is reported by the check function, while it will be seen if only warnings are given, but it would require a redesign of the validation check function to make any improvement in that area, and it's perhaps not worth it. Gbp-Dch: Short
2020-04-23--binary-images can support only a single typeLyndon Brown
whilst some parts of the codebase were set up to work with multiple types specified, others did not work with it and would not necessarily be easy to adjust. this thus makes some tweaks to adjust things accordingly. - option renamed to singular form (maintaining backwards compatibility) - a validation check has been added - unnecessary glob style type references fixed - checks with In_list changed to a direct singular comparison - typo of type "netboot" written as just "net" fixed (though unreachable so of no consequence; really the code could be removed but it's trivial) Gbp-Dch: Short
2020-04-23manpages: fix typoLyndon Brown
Closes: #926238
2020-04-23manpages: fix typoLyndon Brown
bad escape, '-\' should have been '\-' resulted in test showing "--mirror-tstrap" instead of "--mirror-bootstrap" Gbp-Dch: Ignore
2020-04-23manpages: remove unhelpful and largely obsolete fixme noticesLyndon Brown
2020-04-23fix incorrect handling of -c|--conffileLyndon Brown
this option actually only has an impact when used for `lb config`; it thus was incorrectly accepted and captured by Arguments() and the documentation was wrong. going back through git history, this has been incorrect since the v0.99 days. also, reorganised the list alphabetically (no-color was inserted in the wrong place). Gbp-Dch: Short
2020-04-23manpages: fixup synopsisLyndon Brown
live-build page: list of individual commands outdated (color options not added); incorrect (conffile is `lb config` specific as to be addressed otherwise separately); is unnecessary here; and the synopsis suggests usage without a command (e.g. `lb --help` is wrong when it is not). lb: consistensy fix in formatting. all: placeholders should be in capitals for consistency; "OPTIONS" is better the "live-build options" as a placeholder. config: unlike the others where "live-build options" is replaced with "OPTIONS", it makes more sense to specifically list the info (help; usage; version} options, since below the full list of other options including other generic options are given. Gbp-Dch: Short
2020-04-23manpages: fix mistakeLyndon Brown
Gbp-Dch: Ignore
2020-04-23config: support comma and space separated list of source image typesLyndon Brown
2020-04-23manpages: document that multiple source image types can be requestedLyndon Brown
the same is not the case for binary images since although some parts of the codebase support it, others do not. Gbp-Dch: Short
2020-04-23manpages: revise documentation of --linux-packagesLyndon Brown
including documenting use of the value "none" Gbp-Dch: Short
2020-04-23manpages: document that --linux-flavours is space separatedLyndon Brown
2020-04-23manpages: fix typoLyndon Brown
"more than that" -> "more than one" Gbp-Dch: Ignore
2020-04-23manpages: document space separation for --keyring-packagesLyndon Brown
2020-04-23manpages: document all values for --interactiveLyndon Brown
2020-04-23config: support comma or space separated archive area listsLyndon Brown
2020-04-23config: support both comma and space separated to-cache stagesLyndon Brown
2020-04-23manpage: document that multiple stages to cache should be space separatedLyndon Brown
2020-04-23manpage: fix consistency issuesLyndon Brown
- in underlining option parameters - in some cases of single or multiple (quoted + space separated) values Gbp-Dch: Ignore
2020-04-23manpages: indicate in usage that multiple bootloaders can be givenLyndon Brown
Gbp-Dch: Ignore
2020-04-23bootloaders: improve bootloader list handlingLyndon Brown
two parts of the code worked with both comma and space separated lists, while two others only worked with comma separated. swapping out commas with spaces when we setup the var in Set_config_defaults() means that individual scripts no longer need to worry about it and everything supports both; and that we can avoid the IFS/OLDIFS mess. Gbp-Dch: Short
2020-04-23manpages: fix mistakeLyndon Brown
the bootloader list should be comma separated not space. i do not know what possessed me to write space based in aed4e0fef2b87e20ea13ea86d36b9b12ac23426d. fix "booloader" typo while at it. Gbp-Dch: Ignore
2020-04-23manpage: document that multiple archive areas should be space separatedLyndon Brown
2020-04-23chroot_prep: expand coverageLyndon Brown
it now covers: - `lb chroot_apt install-binary` - `lb chroot_archives {chroot|binary|source} {install|remove}` by expanding usage from: `lb chroot_prep {install|remove} HELPERS [ARGS]` to: `lb chroot_prep {install|remove} HELPERS [MODE[ MODE..]] [ARGS]` where `[MODE[ MODE..]]` is an optional set of one or more of: - archives-chroot, which specifies to use 'chroot' as the first param to the chroot_archives script - archives-binary, which specifies to use 'binary' - archives-source, which specifies to use 'source' - apt-install-binary, which specified to pass 'install-binary' instead of 'install' to chroot_apt thus _all_ chroot prep scripts can be run through this helper now! note, in the case of the binary stage, 'archives' is deliberately not added to CHROOT_PREP_OTHER, this is not a mistake! Gbp-Dch: Short
2020-04-23add bulk chroot preparation script execution helperLyndon Brown
rather than explicitly running one helper after another in the major build stages, or by hand (e.g. while testing things during development), they can be run in bulk via this new helper. it essentially just takes a list of helpers to run and runs them one by one. it supports running all helpers except chroot_archives because that one has different parameter requirements to the rest and supporting it would make things messier. helper scripts can either be named by their full script name or without the 'chroot_' prefix for brevity. you can also just specify 'all' to refer to all helpers (except chroot_archives, per above). it automatically reverses the order of the list when run in remove mode. Gbp-Dch: Short
2020-03-28manpages: fix missing mention of stageLyndon Brown
Gbp-Dch: Ignore
2020-03-20manpages: stage clarificationsLyndon Brown
Gbp-Dch: Ignore
2020-03-20manpages: clarify `lb config` notesLyndon Brown
2020-03-20manpages: grammarLyndon Brown
"each" -> "each time" Gbp-Dch: Ignore
2020-03-20manpages: add missing mention of --color|---no-colorLyndon Brown
2020-03-20defaults: enable d-i GUI for allLyndon Brown
2020-03-20defaults: ensure labels have defaults for derivativesLyndon Brown
2020-03-20strip progress-linux distro hacksLyndon Brown
progress-linux, as discussed in MR #142 ([1]) is a little known distro, which appears to be little more than a personal project of the original author of live-build. given that, the expense of maintaining all of these old hacks for it cannot be justified. it is not known whether or not live-build is even used with respect to it since the author abandoned live-build some years ago. also, at least one past change in live-build possibly broke progress-linux compatibility anyway, which would have required progress-linux users of live-build to use a custom progress-linux config, or a progress-linux fork of live-build, and there is no knowing how much of the hacks in this "upstream" codebase any user of progress-linux currently relies upon. and again, progress-linux appears to just be a personal project of Daniel's, with afaik very little userbase. (Daniel seems to be the only developer working on the project which speaks to how small it is). [1]: https://salsa.debian.org/live-team/live-build/-/merge_requests/142 Gbp-Dch: Short
2020-03-20grub: remove old and unused splash codejnqnfe
The LB_GRUB_SPLASH variable is populated by the --grub-splash param but is not actually used for anything. Gbp-Dch: Short
2020-03-17manpages: correct date & versionLyndon Brown
Gbp-Dch: Ignore
2020-03-16allow turning off colourLyndon Brown
necessary to give control when colour is default enabled Gbp-Dch: Short