Adam Spiers
9c402559d2
Include the preamble in online versions of the manual
...
This is more inline with the suggestion in the texinfo manual:
https://www.gnu.org/software/texinfo/manual/texinfo/html_node/_0040top-Command.html
and also the preamble is useful in all cases.
2019-06-26 13:46:37 +01:00
Adam Spiers
b4cb6e775a
Add Guillaume and myself to the list of @authors
2019-06-26 13:46:37 +01:00
Adam Spiers
e647c53af1
Add some polish to the release process
2019-06-25 20:05:47 +01:00
Charles LeDoux
dc42c34107
Add function to expand ~ in .stowrc files ( #14 )
...
Add a new expand_tilde() function that performs tilde expansion of
strings, and corresponding unit tests:
* A ~ at the beginning of a path is expanded to the user's home
directory.
* Literal '~' can be provided with '\~'
Combine this with expand_environment() in a new expand_filepath()
function which applies all (both) required expansion functions to a
string, and use that in get_config_file_options() to expand .stowrc
options.
Add more tests to check that tilde expanded in correct places, i.e.:
* expanded for --target and --dir
* not expanded for --ignore, --defer, or --override
Update documentation on stowrc files according to this functionality
change.
Fixes #14 : https://github.com/aspiers/stow/issues/14
2019-06-25 19:38:43 +01:00
Adam Spiers
c3cbdeb812
Synchronise --verbose documentation
...
The man page was updated with regard to higher --verbose levels but
not the info manual, so fix that.
2019-06-25 17:41:17 +01:00
Adam Spiers
72ef83cebd
Fix old descriptions of Stow ( #22 )
...
De-emphasise the package management aspects, since these days
almost everyone prefers to use modern package managers such as
rpm / dpkg / Nix for (system-wide) package management.
Also include more popular modern use cases for Stow such as management
of dotfiles and software compiled in the user's $HOME directory.
Fixes #22 : https://github.com/aspiers/stow/issues/22
2019-06-25 16:52:33 +01:00
Adam Spiers
dd42b09a5b
avoid "regex" abbreviation for consistency
2018-02-11 17:55:40 +00:00
Adam Spiers
c84de4eb14
fix erroneous glob examples in --ignore documentation
...
Many thanks to Daniel Shahaf for noticing this.
http://lists.gnu.org/archive/html/bug-stow/2017-07/msg00000.html
2018-02-11 17:55:31 +00:00
Adam Spiers
e7e6c7fbde
update the introductory text to clarify Stow's common usage
...
Thanks to Jean Louis for some suggestions on this.
2018-02-11 11:47:39 +00:00
Adam Spiers
ea11f266a5
fix typo in "Deleting Packages" chapter
...
Thanks to Hongyi Zhao for spotting this error and reporting it.
2017-03-04 14:29:06 +00:00
Adam Spiers
b160a1c807
clarify that ~/.stowrc args don't get processed by a shell
...
Address confusion reported here:
http://lists.gnu.org/archive/html/bug-stow/2016-08/msg00000.html
2016-12-18 23:17:19 +00:00
Adam Spiers
5a8d275c47
replace a "you" typo with better text
...
The contents are prepended to the arguments; they still come after the
stow executable.
2016-12-18 23:14:39 +00:00
Adam Spiers
fd10706ce3
HOWTO-RELEASE: use Docker to test before releasing
...
Charles LeDoux did some awesome work providing this Docker environment
which can test across multiple Perl versions using perlbrew, so it
would be crazy not to use it.
2016-11-20 22:57:39 +00:00
Adam Spiers
98a8f7e3e7
use PAUSE upload for final validation step of release
2016-11-20 22:50:22 +00:00
Adam Spiers
a9f79c6a5b
make sure release tags are also pushed to GitHub
2016-11-20 22:50:22 +00:00
Adam Spiers
17bbfb05c6
further refine the release process
...
Let's try a new approach where we increment the version number
immediately after publishing a release, not just before.
This will mean that anyone who builds from git gets a version of Stow
which is higher than the release which was just cut, and this could
provide valuable debugging hints in case a bug report does not clearly
state whether the problem arose with the latest release or with a build
from git.
2016-11-20 22:50:22 +00:00
Adam Spiers
08bff6df00
whitespace cleanups
2016-11-20 22:20:46 +00:00
Adam Spiers
0bc06e58e1
HOWTO-RELEASE: add a reminder to update THANKS
...
Make sure the maintainer always gives credit to contributors :-)
2016-11-20 22:07:47 +00:00
Adam Spiers
d82b6aa1a8
HOWTO-RELEASE: remove body indent
2015-11-09 11:05:20 +00:00
Adam Spiers
ee118fb616
HOWTO-RELEASE: add link to official GNU maintainers guide
2015-11-09 11:05:14 +00:00
Adam Spiers
2119e75d2b
HOWTO-RELEASE: encourage use of SemVer
2015-11-09 10:13:34 +00:00
Adam Spiers
0a54a6bbab
HOWTO-RELEASE: encourage GPG-signing of release tags
2015-11-09 10:11:59 +00:00
Adam Spiers
7faa1d86dc
HOWTO-RELEASE: use gnulib for gendocs instead of texinfo
...
These days it seems that gendocs can be done entirely from
the templates in gnulib, rather than requiring the texinfo
repository.
2015-11-09 10:10:36 +00:00
Adam Spiers
f1b67d2432
HOWTO-RELEASE: include automake --add-missing
...
This is necessary since automake files were removed from the repository
recently.
2015-11-09 09:28:51 +00:00
Adam Spiers
29a8b5d4e5
Add more index entries to the manual.
2015-11-09 09:03:49 +00:00
Adam Spiers
e255b27976
Fix a typo in the docs.
2015-11-09 09:03:42 +00:00
Adam Spiers
db784f0a5f
Fix typo in manual.
2012-02-19 01:42:10 +00:00
Adam Spiers
037ce9ee8a
Add a few more items to index.
2012-02-19 01:42:04 +00:00
Adam Spiers
50d28a4306
Add boilerplate commit message for web docs update.
2012-02-18 20:43:20 +00:00
Adam Spiers
ed12c787df
Add --no-folding option.
2012-02-18 20:33:34 +00:00
Adam Spiers
17d3586e84
Remove -a option for safety reasons (but keep --adopt).
2012-02-18 20:33:34 +00:00
Adam Spiers
1af824908d
Last known bug was fixed a long time ago :-)
2012-02-18 20:33:34 +00:00
Adam Spiers
52d7e2f384
Update structure of manual to match recommended texinfo structure.
...
TOC now appears after title page.
Copying information is no longer duplicated.
2012-02-18 20:33:34 +00:00
Adam Spiers
934ff5e273
Fix various formatting issues in the manual.
2012-02-18 20:20:15 +00:00
Adam Spiers
2ae90481cb
Add some more index entries to the manual.
2012-02-18 20:20:13 +00:00
Adam Spiers
c6a45b7c81
Add some @sections to the manual to break larger nodes up.
2012-02-18 20:19:45 +00:00
Adam Spiers
149034de9f
Use @command / @samp / @env / @var in the manual where appropriate, rather than @code.
2012-02-18 20:19:44 +00:00
Adam Spiers
2da2f44a20
Fix formatting of regexp values in the manual.
2012-02-18 20:19:44 +00:00
Adam Spiers
92eee74bb3
perl Build.PL needs a prefix during testing
2012-01-09 22:10:48 +00:00
Adam Spiers
7e44666640
Add --adopt / -a option.
2012-01-09 21:29:34 +00:00
Adam Spiers
782836bad7
Improve the footnote which defines 'subpath'.
2011-12-21 11:45:59 +00:00
Adam Spiers
7c90000393
Add another ignore example to the manual and test suite.
2011-12-21 11:45:43 +00:00
Adam Spiers
1f35c6c94f
Automate check for 'use lib' line in bin/stow.
2011-12-11 13:16:03 +00:00
Adam Spiers
195c80e9d7
Significantly improve the handling of --with-pmdir.
2011-12-07 20:48:50 +00:00
Adam Spiers
e7e0646db0
Ensure the ChangeLog is up-to-date when making a new distribution.
...
Thanks to Stefano Lattarini for this suggestion.
2011-12-07 01:23:41 +00:00
Adam Spiers
7b62cbf09a
Add a workaround for not being able to ensure that git commit triggers
...
ChangeLog update.
2011-12-06 17:31:10 +00:00
Adam Spiers
9dbe5e4c92
Fix release instructions regarding CPAN distribution.
2011-12-06 17:23:09 +00:00
Adam Spiers
419e31b4c6
Change @dircategory to `System administration' as suggested by Karl Berry.
2011-12-04 14:57:34 +00:00
Adam Spiers
f032e30cc8
Add git push and update of online documentation to HOWTO-RELEASE.
2011-12-03 18:13:09 +00:00
Adam Spiers
f5d0bd178d
Release announcements should go to stow-devel too.
2011-12-03 17:51:48 +00:00