]> git.e2factory.org Git - e2factory.git/commitdiff
cleanup: remove e2-buildid(1) manual page
authorGordon Hecker <gh@emlix.com>
Wed, 20 Jan 2010 17:20:46 +0000 (18:20 +0100)
committerGordon Hecker <gh@emlix.com>
Fri, 12 Feb 2010 09:51:59 +0000 (10:51 +0100)
Signed-off-by: Gordon Hecker <gh@emlix.com>
doc/man/Makefile
doc/man/e2-buildid.1 [deleted file]
doc/man/e2intro.7

index a38f7a1a7642a2df5a0dc91f8a03501a50b77999..10d84ae75d4dd5d8d38a54219b02111f92d488ba 100644 (file)
@@ -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 (file)
index 27d36eb..0000000
+++ /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/<result>", 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
index 796faa9e394681dc177fd4ebb339c9d7aa1d348e..3513b9e5822ab6b8a331dddd7660fd60b688d260 100644 (file)
@@ -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)