From a321187732945a2fc77657d12e2dbd6257465683 Mon Sep 17 00:00:00 2001 From: Gordon Hecker Date: Wed, 20 Jan 2010 18:20:46 +0100 Subject: [PATCH] cleanup: remove e2-buildid(1) manual page Signed-off-by: Gordon Hecker --- doc/man/Makefile | 1 - doc/man/e2-buildid.1 | 88 -------------------------------------------- doc/man/e2intro.7 | 4 -- 3 files changed, 93 deletions(-) delete mode 100644 doc/man/e2-buildid.1 diff --git a/doc/man/Makefile b/doc/man/Makefile index a38f7a1..10d84ae 100644 --- a/doc/man/Makefile +++ b/doc/man/Makefile @@ -32,7 +32,6 @@ include $(TOPLEVEL)/make.vars MANPAGES1 = \ e2.1 \ e2-build.1 \ -e2-buildid.1 \ e2-cf.1 \ e2-create-project.1 \ e2-dlist.1 \ diff --git a/doc/man/e2-buildid.1 b/doc/man/e2-buildid.1 deleted file mode 100644 index 27d36eb..0000000 --- a/doc/man/e2-buildid.1 +++ /dev/null @@ -1,88 +0,0 @@ -.\" Man page for e2-buildid -.\" -.\" (c)2007 emlix GmbH -.\" -.TH e2-buildid 1 "Aug 2, 2007" "0.1" - -.SH NAME -e2-buildid \- computes the build-id for a given result - -.SH SYNOPSIS -e2-buildid [OPTION | RESULT ...] - -.SH DESCRIPTION -To avoid rebuilding whole projects everytime a change is done, for -each distinct result in a project, a finger print for its sources and -configuration is calculated, called "build id". Result files are -stored in a sub directory to "out/", which is named after the -build-id. This directory is checked to see whether a single result -must be rebuilt due to source changes. Note that the build-id of -dependencies of a result influence the id of the result itself. - -For temporary results (mode local), the build id is always the dummy -value "last". - -The algorithm for the build id is as follows: - -.nf - bhash(result) :- sha1sum(for r in {dlist(result), result} phash(r)) - dlist(result) :- dependencies for result, including indirect - phash(result) :- sha1sum(bchroot(result), - for f in {proj/chroot, - proj/env, - proj/init/*, - res/result/build-script, - res/result/config:files - } sha1sum(f), - for s in sources revisionid(s)) - bchroot(result) :- sha1sum(for g in chrootgroups[result] ghash(g)) - ghash(group) :- sha1sum(for e in chroot/group: server, file) - revisionid(source:files) :- sha1sum( - for f in expanded_files_list(source) sha1sum(f) + basename(f)) -.fi - -The tool \fBe2-ls-project\fR(1) uses the build-id algorithm to check -whether results have been built, when called with the "--status" flag. - -\fBe2-buildid\fR writes the build-id for the result and in the build mode -passed in the "RESULT" and "MODE" arguments to standard output. - -.SH RETURN VALUE -Normally, exit status is 0. On error, it is non-zero. - -.SH OPTIONS -.TP -.BR \-\-all -Compute build-ids for all results (default unless for working copy). -.TP -.BR -.BR \-\-tag -Compute build-id based on tagged sources from repository. -.TP -.BR \-\-head -Compute build-id for head revision of sources from repository. -.TP -.BR \-\-working\-copy -Show build-id for local working copies: 'last' always. -.TP -.BR \-\-ignore\-env=VARIABLE -Ignore a particular project environment variable when computing the build-id. -.TP -.BR \-\-help -Show usage information. - -.P -For further global options, see \fBe2intro\fR(7). - -.SH BUGS -Doubtless there are many. - -.SH "SEE ALSO" -.BR e2intro (7), -.BR e2-ls-project (1). - -.SH AUTHORS -Gordon Hecker, Oskar Schirmer and Felix Winkelmann - -.SH COPYRIGHT -(c)2007 emlix GmbH diff --git a/doc/man/e2intro.7 b/doc/man/e2intro.7 index 796faa9..3513b9e 100644 --- a/doc/man/e2intro.7 +++ b/doc/man/e2intro.7 @@ -70,9 +70,6 @@ current working copy, or the appropriate revision from the corresponding repository, when the source is located in a version controlled repository. .TP -.BR e2-buildid -Computes the build id for a given result, in a given build mode. -.TP .BR e2-dlist Shows a sorted list of the dependencies for a given result. .TP @@ -136,7 +133,6 @@ set ssh options when using the \fBe2ssh\fR(1) \fBssh\fR wrapper. .SH "SEE ALSO" .BR e2workflow(7) .BR e2-build(1) -.BR e2-buildid(1) .BR e2-cf(1) .BR e2-dlist(1) .BR e2-dsort(1) -- 2.39.5