aboutsummaryrefslogtreecommitdiff
path: root/aux (unfollow)
Commit message (Collapse)AuthorFilesLines
2021-06-23aux/workflow/manpages.sh: Refactor how manpages and translations are madeEuAndreh4-55/+109
I didn't like the previous version of aux/workflow/manpages.sh mainly for 2 reasons: 1. its CLI was terrible, ugly and fragile; 2. it mixed handling manpages and handling *translations*. The first step was to split the translations part to a different file: aux/workflow/l10n.sh. Now it has the base logic for running po4a, and can apply it to manpages. It is useful for updating translated files in other scenarios, such as catgets() message catalogs, markdown files, etc. After I used the venerable getopts to handle the command line arguments, and give aux/workflow/manpages.sh a saner interface. I disliked the fact that aux/workflow/manpages.sh still is being used for the "install" and "uninstall" targets. Before this file, the canonical workflow of "make && make install/uninstall" was 100% embedded within the Makefile itself. But now the Makefile calls to an external script for that. This isn't a real cost, other than how obvious the behaviour is for someone looking at the Makefile for the first time. I still chose to do it anyway, because there was already too many things in the Makefile itself, and it was getting worse with time. I made sure to never cross the line of relying on an external tool for the canonical "make && make install/uninstall", and even for "make check". Those all work without requiring any extra tool outside what POSIX defines, such as "sed", "awk", etc. Despite the cost of adding this detour from the liner Makefile flow, I found it to be worth it to call to the external script, as this script can now also be shared across projects, and the customized Makefile be made simpler. In other to remove the "-- $(do_subst)" horrendous hack, I chose to use an inference rule for ".in" files, and remove the "$(do_subst)" variable altogether. Now all the files that need to go through sed should end in ".in", and the Makefile will take care of producing it. The upside is that this model is much better integrater into make itself. Addresses #task-9ee2bbc8-295f-52b7-4104-483869bad017.
2021-06-23git mv doc/*.po po/EuAndreh5-4/+4
2021-06-23aux/workflow/public.sh: Spell out .{svg,png} files (ShellCheck offense)EuAndreh1-1/+1
2021-06-23TODOs.md: Mark #task-f09dedb7-1b25-0b5e-2520-910a9aa32562 as DONEEuAndreh1-1/+5
2021-06-23aux/: Explicitly pass "public/" as a parameter to scriptsEuAndreh6-19/+21
2021-06-23aux/workflow/assert-readme.sh: No need to create the public/ directoryEuAndreh1-2/+0
2021-06-23git grep -l PACKAGE aux/ | xargs sed -i 's/PACKAGE/PROJECT/g'EuAndreh3-9/+9
2021-06-23aux/guix/with-container.sh: Remove -x sh optionEuAndreh1-1/+1
2021-06-23aux/workflow/public.sh: Selectively copy favicon filesEuAndreh1-1/+1
2021-06-22TODOs.md: Add #task-f09dedb7-1b25-0b5e-2520-910a9aa32562EuAndreh1-0/+3
2021-06-22doc/: s/SYNOPSYS/SYNOPSIS/EuAndreh4-10/+10
2021-06-22TODOs.md: Mark #task-9ee2bbc8-295f-52b7-4104-483869bad017 as TODO againEuAndreh1-1/+5
2021-06-22tests/remotes.sh: Supress output of git configEuAndreh1-2/+2
2021-06-22tests/cli-opts.sh: Stop testing behaviour of "locale" commandEuAndreh1-9/+0
2021-06-22tests/remotes.sh: Conditionally set user.{email,name} to work on new env like CIEuAndreh1-1/+11
2021-06-22aux/tests-lib.sh: Add uuid() function, use it on testsEuAndreh3-3/+11
2021-06-22src/git-permalink.sh.in, tests/remotes.sh: Address ShellCheck issuesEuAndreh2-12/+12
2021-06-22CHANGELOG.md: Mention integration testsEuAndreh1-0/+4
2021-06-22TODOs.md: Mark #task-bebbe847-f552-be4b-b886-70a621162b69 as DONEEuAndreh1-1/+5
2021-06-22src/git-permalink.sh.in: Fix #task-bebbe847-f552-be4b-b886-70a621162b69EuAndreh2-18/+16
The issue wan't with getopts but with my usage of it (well, now that's obvious that the problem wouldn't be in the implementation, but on how I was using). The problem was on: 1) my confusion on when and where to "shift"; 2) make sure to look for the "--help" and "--version" long flags before getopts, because it doesn't know about long flags. Those fixed, the tests are now working again.
2021-06-22TODOs.md: Mark #task-ada9b39a-cc42-97b2-bd02-ad9c0adc475c as DONEEuAndreh1-1/+5
2021-06-22tests/remotes.sh: AddEuAndreh3-0/+179
2021-06-22TODOs.md: Mark #task-755d8aa8-d39e-f8ce-d4c8-a8649338fffc as DONEEuAndreh1-1/+5
2021-06-22tests/install-uninstall.sh: AddEuAndreh2-0/+50
2021-06-22src/git-permalink.sh.in: Remove empty lines across translated string variablesEuAndreh1-2/+0
2021-06-22TODOs.md: Add #task-755d8aa8-d39e-f8ce-d4c8-a8649338fffcEuAndreh1-0/+3
2021-06-22tests/cli-opts.sh: Use portable "sh git-permalink" over "./git-permalink"EuAndreh1-15/+15
2021-06-22mv src/git-permalink.sh src/git-permalink.sh.inEuAndreh2-1/+1
2021-06-22CHANGELOG.md: Mention "getopts"EuAndreh1-0/+11
2021-06-22TODOs.md: Mark #task-ada9b39a-cc42-97b2-bd02-ad9c0adc475c as DONEEuAndreh1-1/+5
2021-06-22Add small example of using -- on manpageEuAndreh8-62/+137
2021-06-22TODOs.md: Mark #task-cded56f2-c939-3c69-c818-0fb62d62cfd8 as DONEEuAndreh1-1/+5
2021-06-22aux/tests-lib.sh: Use colours on test outputEuAndreh1-6/+17
2021-06-22tests/cli-opts.sh: Add test_langsEuAndreh1-0/+70
2021-06-22TODOs.md: spellcheckingEuAndreh1-4/+4
2021-06-22TODOs.md: Mark #task-9ee2bbc8-295f-52b7-4104-483869bad017 as DONEEuAndreh1-1/+5
2021-06-22TODOs.md: Add #task-cded56f2-c939-3c69-c818-0fb62d62cfd8EuAndreh1-0/+3
2021-06-22src/git-permalink.sh: Use getopts, handle "--" somewhatEuAndreh1-13/+32
See #task-bebbe847-f552-be4b-b886-70a621162b69.
2021-06-22TODOs.md: Add #task-bebbe847-f552-be4b-b886-70a621162b69EuAndreh1-0/+26
2021-06-22aux/workflow/TODOs.sh: Use <pre> over <span> for visible idsEuAndreh1-1/+1
2021-06-22README.md: Better wording on the installation explanationEuAndreh1-6/+8
2021-06-22TODOs.md: Add #task-ada9b39a-cc42-97b2-bd02-ad9c0adc475cEuAndreh1-0/+3
2021-06-22TODOs.md: Add #task-ab5a4835-3d79-03e4-8342-7f5add40b159EuAndreh1-0/+3
2021-06-21src/git-permalink.sh: Suppress warnings when running "locale"EuAndreh1-1/+1
2021-06-21aux/guix/manifest.scm: Add glibc for the "locale" commandEuAndreh1-1/+2
2021-06-21TODOs.md: Add #decision-1f7db3d5-002e-515e-f209-0d0917228359EuAndreh1-0/+19
2021-06-21src/git-permalink.sh: Use LC_MESSAGES to decide on the languageEuAndreh1-4/+13
First, instead of looking at "${LANG:-}" for choosing the language, we now use LC_MESSAGES from the locale(1) command. LC_MESSAGES is the appropriate place to look at, and it inherits the value of $LANG by default, but can be overriden so that the text messages from a program spits out strings from a language, but use everything else from $LANG (such as LC_NUMERIC), like in: LANG=abc LC_MESSAGES=zzz I took this opportunity to look only at the language and country part of the locale, and not at the codeset or modifier (as in ll_CC.CODESET@modifier), so that as long as the language+country is the same, it uses the according message. This addresses the "Maybe it could be less restrictive of country or encoding" comment on
2021-06-21TODOs.md: Mark #task-717fa8b7-1c92-5766-8872-280ae061bf4b as CANCELLEDEuAndreh1-1/+25
2021-06-21TODOs.md: Mark https://nullprogram.com/blog/2020/08/01/ as CANCELLEDEuAndreh1-1/+8
2021-06-21TODOs.md: Add #task-717fa8b7-1c92-5766-8872-280ae061bf4bEuAndreh1-0/+3
generated by cgit v1.2.3 (git 2.49.0) at 2025-07-13 21:14:32 +0000