Go to file

Elijah Newren 94b7f1563a Comment important codepaths regarding nuking untracked files/dirs In the last few commits we focused on code in unpack-trees.c that mistakenly removed untracked files or directories. There may be more of those, but in this commit we change our focus: callers of toplevel commands that are expected to remove untracked files or directories. As noted previously, we have toplevel commands that are expected to delete untracked files such as 'read-tree --reset', 'reset --hard', and 'checkout --force'. However, that does not mean that other highlevel commands that happen to call these other commands thought about or conveyed to users the possibility that untracked files could be removed. Audit the code for such callsites, and add comments near existing callsites to mention whether these are safe or not. My auditing is somewhat incomplete, though; it skipped several cases: * git-rebase--preserve-merges.sh: is in the process of being deprecated/removed, so I won't leave a note that there are likely more bugs in that script. * contrib/git-new-workdir: why is the -f flag being used in a new empty directory?? It shouldn't hurt, but it seems useless. * git-p4.py: Don't see why -f is needed for a new dir (maybe it's not and is just superfluous), but I'm not at all familiar with the p4 stuff * git-archimport.perl: Don't care; arch is long since dead * git-cvs*.perl: Don't care; cvs is long since dead Also, the reset --hard in builtin/worktree.c looks safe, due to only running in an empty directory. Signed-off-by: Elijah Newren <newren@gmail.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>		2021-09-27 13:38:37 -07:00
.github	Merge branch 'cb/ci-build-pedantic'	2021-09-10 11:46:32 -07:00
Documentation	read-tree, merge-recursive: overwrite ignored files by default	2021-09-27 13:38:37 -07:00
block-sha1	…
builtin	Comment important codepaths regarding nuking untracked files/dirs	2021-09-27 13:38:37 -07:00
ci	Merge branch 'cb/ci-build-pedantic'	2021-09-10 11:46:32 -07:00
compat	Merge branch 'rs/git-mmap-uses-malloc'	2021-09-08 13:30:27 -07:00
contrib	Comment important codepaths regarding nuking untracked files/dirs	2021-09-27 13:38:37 -07:00
ewah	…
git-gui	…
gitk-git	…
gitweb	Merge branch 'gh/gitweb-branch-sort'	2021-09-10 11:46:32 -07:00
mergetools	…
negotiator	…
perl	Merge branch 'ab/send-email-optim'	2021-07-22 13:05:54 -07:00
po	l10n: sv.po: Update Swedish translation (5230t0f0u)	2021-08-16 06:54:20 +08:00
ppc	…
refs	Merge branch 'hn/refs-debug-empty-prefix'	2021-07-28 13:18:04 -07:00
sha1collisiondetection@855827c583	…
sha1dc	…
sha256	…
t	unpack-trees: avoid nuking untracked dir in way of locally deleted file	2021-09-27 13:38:37 -07:00
templates	…
trace2	Merge branch 'es/trace2-log-parent-process-name'	2021-08-24 15:32:40 -07:00
xdiff	…
.cirrus.yml	ci: update freebsd 12 cirrus job	2021-08-12 14:00:52 -07:00
.clang-format	…
.editorconfig	…
.gitattributes	…
.gitignore	…
.gitmodules	…
.mailmap	…
.travis.yml	…
.tsan-suppressions	…
CODE_OF_CONDUCT.md	…
COPYING	…
GIT-VERSION-GEN	The first batch post 2.33	2021-08-24 15:33:23 -07:00
INSTALL	…
LGPL-2.1	…
Makefile	Merge branch 'bs/install-strip'	2021-09-15 13:15:26 -07:00
README.md	…
RelNotes	The first batch post 2.33	2021-08-24 15:33:23 -07:00
SECURITY.md	…
abspath.c	…
aclocal.m4	…
add-interactive.c	…
add-interactive.h	…
add-patch.c	…
advice.c	Merge branch 'ab/retire-advice-config'	2021-09-10 11:46:29 -07:00
advice.h	Merge branch 'ab/retire-advice-config'	2021-09-10 11:46:29 -07:00
alias.c	…
alias.h	…
alloc.c	…
alloc.h	…
apply.c	Merge branch 'jc/trivial-threeway-binary-merge'	2021-09-15 13:15:26 -07:00
apply.h	…
archive-tar.c	…
archive-zip.c	…
archive.c	archive: convert queue_directory to struct object_id	2021-08-27 14:19:00 -07:00
archive.h	…
attr.c	…
attr.h	…
banned.h	…
base85.c	…
bisect.c	bisect: simplify return code from bisect_checkout()	2021-07-28 10:57:37 -07:00
bisect.h	…
blame.c	…
blame.h	…
blob.c	…
blob.h	…
bloom.c	…
bloom.h	…
branch.c	advice: remove read uses of most global `advice_` variables	2021-08-25 12:07:52 -07:00
branch.h	…
builtin.h	…
bulk-checkin.c	…
bulk-checkin.h	…
bundle.c	…
bundle.h	…
cache-tree.c	Merge branch 'ds/commit-and-checkout-with-sparse-index'	2021-08-04 13:28:53 -07:00
cache-tree.h	…
cache.h	Merge branch 'js/expand-runtime-prefix'	2021-08-24 15:32:38 -07:00
cbtree.c	…
cbtree.h	oidtree: avoid unaligned access to crit-bit tree	2021-08-15 13:13:50 -07:00
chdir-notify.c	…
chdir-notify.h	…
check-builtins.sh	…
checkout.c	…
checkout.h	…
chunk-format.c	…
chunk-format.h	…
color.c	…
color.h	…
column.c	…
column.h	…
combine-diff.c	…
command-list.txt	…
commit-graph.c	revision: avoid hitting packfiles when commits are in commit-graph	2021-08-09 09:51:12 -07:00
commit-graph.h	revision: avoid hitting packfiles when commits are in commit-graph	2021-08-09 09:51:12 -07:00
commit-reach.c	…
commit-reach.h	…
commit-slab-decl.h	…
commit-slab-impl.h	…
commit-slab.h	…
commit.c	advice: move advice.graftFileDeprecated squashing to commit.[ch]	2021-08-25 12:07:52 -07:00
commit.h	advice: move advice.graftFileDeprecated squashing to commit.[ch]	2021-08-25 12:07:52 -07:00
common-main.c	…
config.c	Merge branch 'js/expand-runtime-prefix'	2021-08-24 15:32:38 -07:00
config.h	Merge branch 'ds/gender-neutral-doc'	2021-07-16 17:42:53 -07:00
config.mak.dev	…
config.mak.in	…
config.mak.uname	Merge branch 'es/trace2-log-parent-process-name'	2021-08-24 15:32:40 -07:00
configure.ac	…
connect.c	connect, protocol: log negotiated protocol version	2021-08-10 11:46:33 -07:00
connect.h	…
connected.c	connected: do not sort input revisions	2021-08-09 09:51:12 -07:00
connected.h	…
convert.c	convert: release strbuf to avoid leak	2021-07-26 12:19:20 -07:00
convert.h	…
copy.c	…
credential.c	credential: fix leak in credential_apply_config()	2021-08-25 11:41:30 -07:00
credential.h	…
csum-file.c	use xopen() to handle fatal open(2) failures	2021-08-25 14:39:08 -07:00
csum-file.h	Merge branch 'tb/midx-use-checksum'	2021-07-16 17:42:46 -07:00
ctype.c	…
daemon.c	…
date.c	…
decorate.c	…
decorate.h	…
delta-islands.c	…
delta-islands.h	…
delta.h	…
detect-compiler	build: catch clang that identifies itself as "$VENDOR clang"	2021-08-06 13:35:37 -07:00
diff-delta.c	…
diff-lib.c	Merge branch 'dd/diff-files-unmerged-fix'	2021-09-08 13:30:31 -07:00
diff-merges.c	diff-index: restore -c/--cc options handling	2021-09-07 11:11:35 -07:00
diff-merges.h	diff-index: restore -c/--cc options handling	2021-09-07 11:11:35 -07:00
diff-no-index.c	…
diff.c	Merge branch 'ab/pickaxe-pcre2'	2021-08-06 12:52:15 -07:00
diff.h	…
diffcore-break.c	…
diffcore-delta.c	…
diffcore-order.c	…
diffcore-pickaxe.c	…
diffcore-rename.c	Merge branch 'en/ort-perf-batch-15'	2021-08-24 15:32:39 -07:00
diffcore-rotate.c	…
diffcore.h	merge-ort: store filepairs and filespecs in our mem_pool	2021-07-30 09:01:19 -07:00
dir-iterator.c	…
dir-iterator.h	…
dir.c	use fspathhash() everywhere	2021-07-30 12:14:27 -07:00
dir.h	Merge branch 'ew/many-alternate-optim'	2021-07-28 13:17:57 -07:00
editor.c	advice: remove read uses of most global `advice_` variables	2021-08-25 12:07:52 -07:00
entry.c	checkout: make delayed checkout respect --quiet and --no-progress	2021-08-26 23:15:33 -07:00
entry.h	checkout: make delayed checkout respect --quiet and --no-progress	2021-08-26 23:15:33 -07:00
environment.c	environment: move strbuf into block to plug leak	2021-07-26 12:19:20 -07:00
environment.h	…
exec-cmd.c	…
exec-cmd.h	…
fetch-negotiator.c	…
fetch-negotiator.h	…
fetch-pack.c	Merge branch 'ps/fetch-pack-load-refs-optim'	2021-08-24 15:32:41 -07:00
fetch-pack.h	…
fmt-merge-msg.c	fmt-merge-msg: free newly allocated temporary strings when done	2021-07-26 12:19:19 -07:00
fmt-merge-msg.h	…
fsck.c	…
fsck.h	…
fsmonitor.c	…
fsmonitor.h	…
fuzz-commit-graph.c	…
fuzz-pack-headers.c	…
fuzz-pack-idx.c	…
generate-cmdlist.sh	…
generate-configlist.sh	…
gettext.c	…
gettext.h	…
git-add--interactive.perl	…
git-archimport.perl	…
git-bisect.sh	…
git-compat-util.h	Merge branch 'ew/mmap-failures'	2021-07-16 17:42:47 -07:00
git-cvsexportcommit.perl	…
git-cvsimport.perl	…
git-cvsserver.perl	…
git-difftool--helper.sh	…
git-filter-branch.sh	…
git-instaweb.sh	…
git-merge-octopus.sh	…
git-merge-one-file.sh	…
git-merge-resolve.sh	…
git-mergetool--lib.sh	…
git-mergetool.sh	…
git-p4.py	…
git-quiltimport.sh	…
git-rebase--preserve-merges.sh	…
git-request-pull.sh	…
git-send-email.perl	Merge branch 'ab/send-email-config-fix'	2021-09-15 13:15:24 -07:00
git-sh-i18n.sh	…
git-sh-setup.sh	…
git-submodule.sh	Merge branch 'ar/submodule-add'	2021-08-04 13:28:52 -07:00
git-svn.perl	…
git-web--browse.sh	…
git.c	…
git.rc	…
gpg-interface.c	…
gpg-interface.h	…
graph.c	…
graph.h	…
grep.c	…
grep.h	…
hash-lookup.c	…
hash-lookup.h	…
hash.h	oidtree: avoid unaligned access to crit-bit tree	2021-08-15 13:13:50 -07:00
hashmap.c	…
hashmap.h	…
help.c	help.c: help.autocorrect=prompt waits for user action	2021-08-14 11:20:49 -07:00
help.h	…
hex.c	…
http-backend.c	…
http-fetch.c	…
http-push.c	http: rename CURLOPT_FILE to CURLOPT_WRITEDATA	2021-07-30 16:01:54 -07:00
http-walker.c	http: rename CURLOPT_FILE to CURLOPT_WRITEDATA	2021-07-30 16:01:54 -07:00
http.c	http: rename CURLOPT_FILE to CURLOPT_WRITEDATA	2021-07-30 16:01:54 -07:00
http.h	http: drop support for curl < 7.19.3 and < 7.17.0 (again)	2021-07-30 16:00:10 -07:00
ident.c	…
imap-send.c	Merge branch 'ab/http-drop-old-curl'	2021-08-24 15:32:36 -07:00
iterator.h	…
json-writer.c	…
json-writer.h	…
khash.h	…
kwset.c	…
kwset.h	…
levenshtein.c	…
levenshtein.h	…
line-log.c	…
line-log.h	…
line-range.c	…
line-range.h	…
linear-assignment.c	…
linear-assignment.h	…
list-objects-filter-options.c	…
list-objects-filter-options.h	…
list-objects-filter.c	…
list-objects-filter.h	…
list-objects.c	list-objects.c: rename "traverse_trees_and_blobs" to "traverse_non_commits"	2021-08-12 13:08:30 -07:00
list-objects.h	…
list.h	…
ll-merge.c	…
ll-merge.h	…
lockfile.c	…
lockfile.h	…
log-tree.c	load_ref_decorations(): fix decoration with tags	2021-07-14 10:11:02 -07:00
log-tree.h	…
ls-refs.c	ls-refs: reuse buffer when sending refs	2021-08-25 15:55:29 -07:00
ls-refs.h	…
mailinfo.c	…
mailinfo.h	…
mailmap.c	Merge branch 'ab/mailmap-leakfix'	2021-09-10 11:46:28 -07:00
mailmap.h	…
match-trees.c	…
mem-pool.c	…
mem-pool.h	…
merge-blobs.c	…
merge-blobs.h	…
merge-ort-wrappers.c	…
merge-ort-wrappers.h	…
merge-ort.c	Remove ignored files by default when they are in the way	2021-09-27 13:38:37 -07:00
merge-ort.h	…
merge-recursive.c	unpack-trees: introduce preserve_ignored to unpack_trees_options	2021-09-27 13:38:37 -07:00
merge-recursive.h	…
merge.c	unpack-trees: introduce preserve_ignored to unpack_trees_options	2021-09-27 13:38:37 -07:00
mergesort.c	…
mergesort.h	…
midx.c	Merge branch 'ab/attribute-format'	2021-07-28 13:17:59 -07:00
midx.h	…
name-hash.c	…
notes-cache.c	…
notes-cache.h	…
notes-merge.c	advice: remove read uses of most global `advice_` variables	2021-08-25 12:07:52 -07:00
notes-merge.h	…
notes-utils.c	…
notes-utils.h	…
notes.c	…
notes.h	…
object-file.c	Merge branch 'cb/many-alternate-optim-fixup'	2021-08-11 12:36:17 -07:00
object-name.c	advice: remove read uses of most global `advice_` variables	2021-08-25 12:07:52 -07:00
object-store.h	object-store.h: teach for_each_packed_object to ignore kept packs	2021-08-29 23:23:39 -07:00
object.c	Merge branch 'jk/log-decorate-optim'	2021-07-28 13:17:58 -07:00
object.h	builtin/pack-objects.c: remove duplicate hash lookup	2021-08-29 23:25:43 -07:00
oid-array.c	…
oid-array.h	…
oidmap.c	…
oidmap.h	…
oidset.c	…
oidset.h	…
oidtree.c	oidtree: avoid unaligned access to crit-bit tree	2021-08-15 13:13:50 -07:00
oidtree.h	…
pack-bitmap-write.c	…
pack-bitmap.c	Merge branch 'jk/check-pack-valid-before-opening-bitmap'	2021-08-02 14:06:43 -07:00
pack-bitmap.h	…
pack-check.c	…
pack-objects.c	…
pack-objects.h	…
pack-revindex.c	…
pack-revindex.h	…
pack-write.c	Merge branch 'ab/reverse-midx-optim'	2021-09-15 13:15:27 -07:00
pack.h	…
packfile.c	object-store.h: teach for_each_packed_object to ignore kept packs	2021-08-29 23:23:39 -07:00
packfile.h	…
pager.c	…
parallel-checkout.c	…
parallel-checkout.h	…
parse-options-cb.c	…
parse-options.c	parse-options: don't complete option aliases by default	2021-07-16 11:31:44 -07:00
parse-options.h	…
patch-delta.c	…
patch-ids.c	…
patch-ids.h	…
path.c	interpolate_path(): allow specifying paths relative to the runtime prefix	2021-07-26 12:17:16 -07:00
path.h	…
pathspec.c	pathspec: stop calling ensure_full_index	2021-07-29 12:36:34 -07:00
pathspec.h	Merge branch 'ds/gender-neutral-doc'	2021-07-16 17:42:53 -07:00
pkt-line.c	Merge branch 'dl/packet-read-response-end-fix'	2021-07-28 13:17:56 -07:00
pkt-line.h	…
preload-index.c	…
pretty.c	logmsg_reencode(): warn when iconv() fails	2021-08-27 12:43:22 -07:00
pretty.h	…
prio-queue.c	…
prio-queue.h	…
progress.c	…
progress.h	…
promisor-remote.c	Merge branch 'jt/partial-clone-submodule-1'	2021-07-16 17:42:53 -07:00
promisor-remote.h	…
prompt.c	…
prompt.h	…
protocol-caps.c	protocol-caps.c: fix memory leak in send_info()	2021-08-31 11:15:16 -07:00
protocol-caps.h	…
protocol.c	connect, protocol: log negotiated protocol version	2021-08-10 11:46:33 -07:00
protocol.h	…
prune-packed.c	…
prune-packed.h	…
quote.c	ref-filter: --format=%(raw) support --perl	2021-07-26 12:01:25 -07:00
quote.h	Merge branch 'zh/ref-filter-raw-data'	2021-08-24 15:32:37 -07:00
range-diff.c	Merge branch 'rs/range-diff-avoid-segfault-with-I'	2021-09-15 13:15:27 -07:00
range-diff.h	…
reachable.c	…
reachable.h	…
read-cache.c	Merge branch 'ah/plugleaks'	2021-08-04 13:28:52 -07:00
rebase-interactive.c	…
rebase-interactive.h	…
rebase.c	…
rebase.h	…
ref-filter.c	Merge branch 'zh/ref-filter-raw-data'	2021-08-24 15:32:37 -07:00
ref-filter.h	ref-filter: add %(rest) atom	2021-07-26 12:01:26 -07:00
reflog-walk.c	…
reflog-walk.h	…
refs.c	Merge branch 'hn/refs-iterator-peel-returns-boolean'	2021-07-16 17:42:49 -07:00
refs.h	…
refspec.c	…
refspec.h	…
remote-curl.c	Merge branch 'ab/http-drop-old-curl'	2021-08-24 15:32:36 -07:00
remote.c	Merge branch 'cb/remote-ndebug-fix'	2021-09-10 11:46:30 -07:00
remote.h	…
replace-object.c	…
replace-object.h	…
repo-settings.c	…
repository.c	…
repository.h	…
rerere.c	…
rerere.h	…
reset.c	Change unpack_trees' 'reset' flag into an enum	2021-09-27 13:38:37 -07:00
reset.h	…
resolve-undo.c	…
resolve-undo.h	…
revision.c	revision: avoid hitting packfiles when commits are in commit-graph	2021-08-09 09:51:12 -07:00
revision.h	revision: separate walk and unsorted flags	2021-08-05 09:37:28 -07:00
run-command.c	Merge branch 'ab/retire-advice-config'	2021-09-10 11:46:29 -07:00
run-command.h	Merge branch 'jt/partial-clone-submodule-1'	2021-07-16 17:42:53 -07:00
send-pack.c	Merge branch 'jt/push-negotiation-fixes'	2021-08-24 15:32:40 -07:00
send-pack.h	…
sequencer.c	Remove ignored files by default when they are in the way	2021-09-27 13:38:37 -07:00
sequencer.h	sequencer: advise if skipping cherry-picked commit	2021-08-30 16:35:36 -07:00
serve.c	Merge branch 'dl/packet-read-response-end-fix'	2021-07-28 13:17:56 -07:00
serve.h	…
server-info.c	…
setup.c	Merge branch 'jt/partial-clone-submodule-1'	2021-07-16 17:42:53 -07:00
sh-i18n--envsubst.c	…
sha1dc_git.c	…
sha1dc_git.h	…
shallow.c	…
shallow.h	…
shell.c	…
shortlog.h	…
sideband.c	…
sideband.h	…
sigchain.c	…
sigchain.h	…
simple-ipc.h	…
sparse-index.c	sparse-index: copy dir_hash in ensure_full_index()	2021-08-30 09:24:12 -07:00
sparse-index.h	…
split-index.c	…
split-index.h	…
stable-qsort.c	…
strbuf.c	…
strbuf.h	Merge branch 'ab/attribute-format'	2021-07-28 13:17:59 -07:00
streaming.c	…
streaming.h	…
string-list.c	…
string-list.h	…
strmap.c	…
strmap.h	…
strvec.c	…
strvec.h	…
sub-process.c	…
sub-process.h	…
submodule-config.c	…
submodule-config.h	…
submodule.c	Comment important codepaths regarding nuking untracked files/dirs	2021-09-27 13:38:37 -07:00
submodule.h	…
symlinks.c	…
tag.c	…
tag.h	…
tar.h	…
tempfile.c	…
tempfile.h	…
thread-utils.c	…
thread-utils.h	…
tmp-objdir.c	…
tmp-objdir.h	…
trace.c	…
trace.h	…
trace2.c	tr2: log parent process name	2021-07-22 13:35:20 -07:00
trace2.h	tr2: log parent process name	2021-07-22 13:35:20 -07:00
trailer.c	…
trailer.h	…
transport-helper.c	…
transport-internal.h	…
transport.c	Merge branch 'ab/struct-init'	2021-07-16 17:42:53 -07:00
transport.h	…
tree-diff.c	…
tree-walk.c	…
tree-walk.h	…
tree.c	…
tree.h	…
unicode-width.h	…
unimplemented.sh	…
unix-socket.c	…
unix-socket.h	…
unix-stream-server.c	…
unix-stream-server.h	…
unpack-trees.c	unpack-trees: avoid nuking untracked dir in way of locally deleted file	2021-09-27 13:38:37 -07:00
unpack-trees.h	Change unpack_trees' 'reset' flag into an enum	2021-09-27 13:38:37 -07:00
upload-pack.c	upload-pack.c: treat want-ref relative to namespace	2021-09-01 07:54:18 -07:00
upload-pack.h	…
url.c	…
url.h	…
urlmatch.c	…
urlmatch.h	…
usage.c	…
userdiff.c	Merge branch 'uk/userdiff-php-enum'	2021-09-10 11:46:27 -07:00
userdiff.h	…
utf8.c	…
utf8.h	…
varint.c	…
varint.h	…
version.c	…
version.h	…
versioncmp.c	…
walker.c	…
walker.h	…
wildmatch.c	…
wildmatch.h	…
worktree.c	…
worktree.h	…
wrap-for-bin.sh	…
wrapper.c	xopen: explicitly report creation failures	2021-08-25 14:39:06 -07:00
write-or-die.c	…
ws.c	…
wt-status.c	advice: remove read uses of most global `advice_` variables	2021-08-25 12:07:52 -07:00
wt-status.h	status: skip sparse-checkout percentage with sparse-index	2021-07-14 13:42:49 -07:00
xdiff-interface.c	…
xdiff-interface.h	…
zlib.c	…

README.md

Git - fast, scalable, distributed revision control system

Git is a fast, scalable, distributed revision control system with an unusually rich command set that provides both high-level operations and full access to internals.

Git is an Open Source project covered by the GNU General Public License version 2 (some parts of it are under different licenses, compatible with the GPLv2). It was originally written by Linus Torvalds with help of a group of hackers around the net.

Please read the file INSTALL for installation instructions.

Many Git online resources are accessible from https://git-scm.com/ including full documentation and Git related tools.

See Documentation/gittutorial.txt to get started, then see Documentation/giteveryday.txt for a useful minimum set of commands, and Documentation/git-<commandname>.txt for documentation of each command. If git has been correctly installed, then the tutorial can also be read with man gittutorial or git help tutorial, and the documentation of each command with man git-<commandname> or git help <commandname>.

CVS users may also want to read Documentation/gitcvs-migration.txt (man gitcvs-migration or git help cvs-migration if git is installed).

The user discussion and development of Git take place on the Git mailing list -- everyone is welcome to post bug reports, feature requests, comments and patches to git@vger.kernel.org (read Documentation/SubmittingPatches for instructions on patch submission). To subscribe to the list, send an email with just "subscribe git" in the body to majordomo@vger.kernel.org. The mailing list archives are available at https://lore.kernel.org/git/, http://marc.info/?l=git and other archival sites.

Issues which are security relevant should be disclosed privately to the Git Security mailing list git-security@googlegroups.com.

The maintainer frequently sends the "What's cooking" reports that list the current status of various development topics to the mailing list. The discussion following them give a good reference for project status, development direction and remaining tasks.

The name "git" was given by Linus Torvalds when he wrote the very first version. He described the tool as "the stupid content tracker" and the name as (depending on your mood):

random three-letter combination that is pronounceable, and not actually used by any common UNIX command. The fact that it is a mispronunciation of "get" may or may not be relevant.
stupid. contemptible and despicable. simple. Take your pick from the dictionary of slang.
"global information tracker": you're in a good mood, and it actually works for you. Angels sing, and a light suddenly fills the room.
"goddamn idiotic truckload of sh*t": when it breaks