[arch-projects] [devtools] [PATCH v2 1/3] doc: Add lddd man page
---
.gitignore | 1 +
Makefile| 22 --
doc/asciidoc.conf | 37 +
doc/footer.asciidoc | 28
doc/lddd.1.asciidoc | 25 +
5 files changed, 111 insertions(+), 2 deletions(-)
create mode 100644 doc/asciidoc.conf
create mode 100644 doc/footer.asciidoc
create mode 100644 doc/lddd.1.asciidoc
diff --git a/.gitignore b/.gitignore
index 1e92b82..04eefe5 100644
--- a/.gitignore
+++ b/.gitignore
@@ -16,3 +16,4 @@ zsh_completion
find-libdeps
crossrepomove
arch-nspawn
+doc/*.1
diff --git a/Makefile b/Makefile
index 2d29c83..80fe1d7 100644
--- a/Makefile
+++ b/Makefile
@@ -1,6 +1,7 @@
V=20180531
PREFIX = /usr/local
+MANDIR = $(PREFIX)/share/man
BINPROGS = \
checkpkg \
@@ -60,7 +61,13 @@ BASHCOMPLETION_LINKS = \
archco \
communityco
-all: $(BINPROGS) bash_completion zsh_completion
+
+MANS = \
+ doc/lddd.1
+
+
+all: $(BINPROGS) bash_completion zsh_completion man
+man: $(MANS)
edit = sed -e "s|@pkgdatadir[@]|$(DESTDIR)$(PREFIX)/share/devtools|g"
@@ -72,8 +79,13 @@ edit = sed -e
"s|@pkgdatadir[@]|$(DESTDIR)$(PREFIX)/share/devtools|g"
@chmod +x "$@"
@bash -O extglob -n "$@"
+$(MANS): doc/asciidoc.conf doc/footer.asciidoc
+
+doc/%: doc/%.asciidoc
+ a2x --no-xmllint --asciidoc-opts="-f doc/asciidoc.conf" -d manpage -f
manpage -D doc $<
+
clean:
- rm -f $(BINPROGS) bash_completion zsh_completion
+ rm -f $(BINPROGS) bash_completion zsh_completion $(MANS)
install:
install -dm0755 $(DESTDIR)$(PREFIX)/bin
@@ -88,6 +100,9 @@ install:
for l in ${BASHCOMPLETION_LINKS}; do ln -sf devtools
$(DESTDIR)/usr/share/bash-completion/completions/$$l; done
install -Dm0644 zsh_completion
$(DESTDIR)$(PREFIX)/share/zsh/site-functions/_devtools
ln -sf archco $(DESTDIR)$(PREFIX)/bin/communityco
+ for manfile in $(MANS); do \
+ install -Dm644 $$manfile -t
$(DESTDIR)$(MANDIR)/man$${manfile##*.}; \
+ done;
uninstall:
for f in ${BINPROGS}; do rm -f $(DESTDIR)$(PREFIX)/bin/$$f; done
@@ -99,6 +114,9 @@ uninstall:
rm $(DESTDIR)$(PREFIX)/share/zsh/site-functions/_devtools
rm -f $(DESTDIR)$(PREFIX)/bin/communityco
rm -f $(DESTDIR)$(PREFIX)/bin/find-libprovides
+ for manfile in $(MANS); do \
+ rm -f $(DESTDIR)$(MANDIR)/man$${manfile##*.}/$${manfile#doc/}; \
+ done;
dist:
git archive --format=tar --prefix=devtools-$(V)/ $(V) | gzip -9 >
devtools-$(V).tar.gz
diff --git a/doc/asciidoc.conf b/doc/asciidoc.conf
new file mode 100644
index 000..c675a20
--- /dev/null
+++ b/doc/asciidoc.conf
@@ -0,0 +1,37 @@
+## linkman: macro
+# Inspired by/borrowed from the GIT source tree at Documentation/asciidoc.conf
+#
+# Usage: linkman:command[manpage-section]
+#
+# Note, {0} is the manpage section, while {target} is the command.
+#
+# Show man link as: (); if section is defined, else just show
+# the command.
+
+[macros]
+(?su)[\\]?(?Plinkman):(?P\S*?)\[(?P.*?)\]=
+
+[attributes]
+asterisk=
+plus=
+caret=
+startsb=
+endsb=
+backslash=
+tilde=
+apostrophe=
+backtick=
+litdd=
+
+ifdef::backend-docbook[]
+[linkman-inlinemacro]
+{0%{target}}
+{0#}
+{0#{target}{0}}
+{0#}
+endif::backend-docbook[]
+
+ifdef::backend-xhtml11[]
+[linkman-inlinemacro]
+{target}{0?({0})}
+endif::backend-xhtml11[]
diff --git a/doc/footer.asciidoc b/doc/footer.asciidoc
new file mode 100644
index 000..a092447
--- /dev/null
+++ b/doc/footer.asciidoc
@@ -0,0 +1,28 @@
+
+Bugs
+
+Bugs can be reported on the bug tracker 'https://bugs.archlinux.org' in the
Arch
+Linux category and title prefixed with [devtools] or via
+mailto:arch-projects@archlinux.org[].
+
+
+Authors
+---
+
+Maintainers:
+
+* Aaron Griffin
+* Allan McRae
+* Bart??omiej Piotrowski
+* Dan McGee
+* Dave Reisner
+* Evangelos Foutras
+* Jan Alexander Steffens (heftig)
+* Levente Polyak
+* Pierre Schmitz
+* S??bastien Luttringer
+* Sven-Hendrik Haase
+* Thomas B??chler
+
+For additional contributors, use `git shortlog -s` on the devtools.git
+repository.
diff --git a/doc/lddd.1.asciidoc b/doc/lddd.1.asciidoc
new file mode 100644
index 000..3a015d2
--- /dev/null
+++ b/doc/lddd.1.asciidoc
@@ -0,0 +1,25 @@
+lddd(1)
+===
+
+Name
+
+lddd - Find broken library links on your system
+
+Synopsis
+
+lddd
+
+Description
+---
+
+Scans '$PATH', '/lib', '/usr/lib', '/usr/local/lib' and
+'/etc/ld.so.conf.d/*.conf' directories for ELF files with references to missing
+shared libraries, and suggests which packages might need to be rebuilt. The
+collected data is written to a temporary directory created by mktemp.
+
+See Also
+
+
+linkman:ldd[1]
+
+include::footer.asciidoc[]
--
2.18.0
[arch-projects] [devtools] [PATCH v2 2/3] doc: Add checkpkg man page
--- Makefile| 3 ++- doc/checkpkg.1.asciidoc | 27 +++ 2 files changed, 29 insertions(+), 1 deletion(-) create mode 100644 doc/checkpkg.1.asciidoc diff --git a/Makefile b/Makefile index 80fe1d7..e812936 100644 --- a/Makefile +++ b/Makefile @@ -63,7 +63,8 @@ BASHCOMPLETION_LINKS = \ MANS = \ - doc/lddd.1 + doc/lddd.1 \ + doc/checkpkg.1 all: $(BINPROGS) bash_completion zsh_completion man diff --git a/doc/checkpkg.1.asciidoc b/doc/checkpkg.1.asciidoc new file mode 100644 index 000..96ec645 --- /dev/null +++ b/doc/checkpkg.1.asciidoc @@ -0,0 +1,27 @@ +checkpkg(1) +=== + +Name + +checkpkg - Compare the current build package with the repository version + +Synopsis + +checkpkg + +Description +--- + +Searches for a locally built package corresponding to the PKGBUILD, and +downloads the last version of that package from the Pacman repositories. It +then compares the list of .so files provided by each version of the package and +outputs if there are soname differences for the new package. A directory is +also created using mktemp with files containing a file list for both packages +and a library list for both packages. + +See Also + + +linkman:find-libprovides[1] + +include::footer.asciidoc[] -- 2.18.0
[arch-projects] [devtools] [PATCH v2 3/3] doc: add find-libprovides man page
--- doc/find-libprovides.1.asciidoc | 24 1 file changed, 24 insertions(+) create mode 100644 doc/find-libprovides.1.asciidoc diff --git a/doc/find-libprovides.1.asciidoc b/doc/find-libprovides.1.asciidoc new file mode 100644 index 000..c6d527d --- /dev/null +++ b/doc/find-libprovides.1.asciidoc @@ -0,0 +1,24 @@ +find-libdeps(1) +=== + +Name + +find-libdeps - Find soname dependencies for a package + +Synopsis + +find-libdeps [options] [package] + +Description +--- + +Finds soname dependencies of a package and prints out a list in the following +format '=-'. + +Options +--- + +*--ignore-internal*:: + Ignore internal libraries + +include::footer.asciidoc[] -- 2.18.0
[arch-projects] [devtools] [PATCH v2 0/3] Add man pages
This is v2 of my man page addition effort, I've switched from mandoc to the much easier asciidoc. Another reason to use asciidoc is that pacman/pacman-contrib also use it. So possible contributors might be more familiar with it. Thanks to Luke Shumaker for some more inspiration for the content! Jelle van der Waa (3): doc: Add lddd man page doc: Add checkpkg man page doc: add find-libprovides man page .gitignore | 1 + Makefile| 23 ++-- doc/asciidoc.conf | 37 + doc/checkpkg.1.asciidoc | 27 doc/find-libprovides.1.asciidoc | 24 + doc/footer.asciidoc | 28 + doc/lddd.1.asciidoc | 25 ++ 7 files changed, 163 insertions(+), 2 deletions(-) create mode 100644 doc/asciidoc.conf create mode 100644 doc/checkpkg.1.asciidoc create mode 100644 doc/find-libprovides.1.asciidoc create mode 100644 doc/footer.asciidoc create mode 100644 doc/lddd.1.asciidoc -- 2.18.0
[arch-projects] [dbscripts] [GIT] Official repo DB scripts branch master updated. 20180603-3-g0b630e2
This is an automated email from the git hooks/post-receive script. It was generated because a ref change was pushed to the repository containing the project "Official repo DB scripts". The branch, master has been updated via 0b630e25a3181d5228cbd99c9041a04b6514fc81 (commit) via 57a307d6620d8fbf3bf1c7d01e621022da4f3f29 (commit) from c53352c103e023727ce31e98ca9647bb918a9a5d (commit) Those revisions listed above that are new to this repository have not appeared on any other notification email; so we list those revisions in full, below. - Log - commit 0b630e25a3181d5228cbd99c9041a04b6514fc81 Author: anthraxx Date: Mon Sep 3 13:50:16 2018 +0200 fix potential bsdtar stream close error by grep This silences a useless error message that confuses the user. bsdtar doesn't like it when the stream gets closed before it finishes which may be the case when grep found its match on potentially huge archives. Instead of suppressing the whole stderr , we find all matches with grep, then use a second pass with `tail` to find only the last match, which ensures the stream remains open for bsdtar but we may still catch and see useful messages on stderr. This works because tail has the useful property of not closing early. commit 57a307d6620d8fbf3bf1c7d01e621022da4f3f29 Author: anthraxx Date: Mon Sep 3 22:01:16 2018 +0200 readme: switch to travis-ci.com build status badge The old travis-ci.org is deprecated and this project was migrated. --- Summary of changes: README.md| 2 +- db-functions | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) hooks/post-receive -- Official repo DB scripts
Re: [arch-projects] [dbscripts] [PATCH 2/2] fixup: fix potential bsdtar stream close error by grep
On 9/9/18 11:20 AM, Eli Schwartz wrote: > On 9/3/18 7:50 AM, Levente Polyak via arch-projects wrote: >> From: anthraxx >> >> bsdtar doesn't like it when the stream gets closed before it finishes >> which may be the case when grep found its match on potentially huge >> archives. Instead of suppressing the whole strerr , we just pipe >> the output through cat which ensures the stream remains open for bsdtar >> but we may still catch and see useful messages on stderr. > > This is functionally 23c2b82c336bf19b7a29a90d19bca4423d8b8839 again, but > for more locations. I'm never going to understand why some people get > this SIGPIPE but I don't, but I guess it makes sense to do this change > -- especially as we do the same elsewhere. > > (We need to buffer it somehow with some extra command, grep doesn't have > a way to only output the first result but still avoid propagating > SIGPIPE. Why does bsdtar care about this anyway...) As discussed on IRC, I can finally reproduce this, e.g. bsdtar xOf /path/to/file | grep --binary-files=text a (many matches for the string "a") With grep -q or grep -m1, it errors with cat | grep -q/-m1 it still errors due to the buffer going *into* grep, having insufficient room :( with grep | head -1 it only errors, if the matching buffer going *out* of grep is too large. For our uses it should only ever match exactly once. So this is what we should do. (Or complain to libarchive. :p) -- Eli Schwartz Bug Wrangler and Trusted User signature.asc Description: OpenPGP digital signature
Re: [arch-projects] [dbscripts] [PATCH 2/2] fixup: fix potential bsdtar stream close error by grep
On 9/3/18 7:50 AM, Levente Polyak via arch-projects wrote: > From: anthraxx > > bsdtar doesn't like it when the stream gets closed before it finishes > which may be the case when grep found its match on potentially huge > archives. Instead of suppressing the whole strerr , we just pipe > the output through cat which ensures the stream remains open for bsdtar > but we may still catch and see useful messages on stderr. This is functionally 23c2b82c336bf19b7a29a90d19bca4423d8b8839 again, but for more locations. I'm never going to understand why some people get this SIGPIPE but I don't, but I guess it makes sense to do this change -- especially as we do the same elsewhere. (We need to buffer it somehow with some extra command, grep doesn't have a way to only output the first result but still avoid propagating SIGPIPE. Why does bsdtar care about this anyway...) Accepted. -- Eli Schwartz Bug Wrangler and Trusted User signature.asc Description: OpenPGP digital signature
