Glossary - Revision history

Morane at 09:52, 5 April 2018

2018-04-05T09:52:44Z

← Older revision		Revision as of 09:52, 5 April 2018
Line 60:		Line 60:
	: (Secure Hash Algorithm) a family of Cryptographic hashes published by the NIST ([https://en.wikipedia.org/wiki/Secure_Hash_Algorithm SHA Wikipedia article])		: (Secure Hash Algorithm) a family of Cryptographic hashes published by the NIST ([https://en.wikipedia.org/wiki/Secure_Hash_Algorithm SHA Wikipedia article])

			; Snapshot
			: the state of all visible branches during a specific visit of an origin

	== V ==		== V ==

StefanoZacchiroli: /* C */

2016-06-25T19:00:40Z

← Older revision		Revision as of 19:00, 25 June 2016
Line 4:		Line 4:
	; Content		; Content
	: a (specific version of a) file stored in the archive, identified by its cryptographic hashes (SHA1, [https://git-scm.com/book/en/v2/Git-Internals-Git-Objects "git-like" SHA1], SHA256) and its size		: a (specific version of a) file stored in the archive, identified by its cryptographic hashes (SHA1, [https://git-scm.com/book/en/v2/Git-Internals-Git-Objects "git-like" SHA1], SHA256) and its size
			: Also known as: Blob
			: Note: it is incorrect to refer to Contents as "files", because files are usually considered to be named, whereas Contents are nameless. It is only in the context of specific Directories that Contents acquire (local) names

	; Cryptographic hash		; Cryptographic hash

StefanoZacchiroli at 18:58, 25 June 2016

2016-06-25T18:58:53Z

← Older revision		Revision as of 18:58, 25 June 2016
Line 3:		Line 3:
	== C ==		== C ==
	; Content		; Content
	: a file stored in the archive, identified by its cryptographic hashes (SHA1, "git-like" SHA1, SHA256) and its size		: a (specific version of a) file stored in the archive, identified by its cryptographic hashes (SHA1, [https://git-scm.com/book/en/v2/Git-Internals-Git-Objects "git-like" SHA1], SHA256) and its size

	; Cryptographic hash		; Cryptographic hash
	: ~~(also called Checksum, Digest)~~ a fixed-size "summary" of a stream of bytes, that is easy to compute, and hard to reverse. ([https://en.wikipedia.org/wiki/Cryptographic_hash_function Cryptographic hash function Wikipedia article])		: a fixed-size "summary" of a stream of bytes that is easy to compute, and hard to reverse. ([https://en.wikipedia.org/wiki/Cryptographic_hash_function Cryptographic hash function Wikipedia article])
			: also known as: Checksum, Digest

	== D ==		== D ==

	; Directory		; Directory
	: a set of named pointers to ~~files~~, directories and revisions		: a set of named pointers to contents (file entries), directories (directory entries) and revisions (revision entries)

	== H ==		== H ==
Line 21:		Line 22:

	; Origin		; Origin
	: ~~(also called Data sources)~~ a location from which a coherent set of sources has been obtained.		: a location from which a coherent set of sources has been obtained.
	: ~~Some examples of origins~~ :		: Also known as: Data source
			: Examples:
	:		:
	:* a [https://github.com/torvalds/linux/ ~~git~~ repository]		:* a [https://github.com/torvalds/linux/ Git repository]
	:* a [https://www.kernel.org/pub/linux/kernel/v4.x/ directory containing tarballs]		:* a [https://www.kernel.org/pub/linux/kernel/v4.x/ directory containing tarballs]
	:* the history of a Debian package on [http://snapshot.debian.org/package/linux/ snapshot.debian.org].		:* the history of a Debian package on [http://snapshot.debian.org/package/linux/ snapshot.debian.org].
Line 31:		Line 33:

	; Project		; Project
	:		: an organized effort to develop a software product. Projects might be nested following organizational structures (sub-project, sub-sub-project), are associated to a number of human-meaningful metadata, and release software products via Origins.

	== R ==		== R ==
Line 37:		Line 39:
	; Release		; Release
	: a revision that has been marked by a project as noteworthy with a specific, usually mnemonic, name (for instance, a version number).		: a revision that has been marked by a project as noteworthy with a specific, usually mnemonic, name (for instance, a version number).
	: ~~Some examples of releases~~ :		: Also known as: Tag (Git-specific terminology)
			: Examples:
	:		:
	:* a ~~git~~ tag with its name		:* a Git tag with its name
	:* a tarball with its name		:* a tarball with its name
	:* a Debian source package with its version number.		:* a Debian source package with its version number.
Line 45:		Line 48:
	; Revision		; Revision
	: a "point in time" snapshot in the development history of a project.		: a "point in time" snapshot in the development history of a project.
	: ~~Some examples of revisions~~ :		: Also known as: Commit (VCS terminology)
			: Examples:
	:		:
	:* a ~~git~~ commit		:* a Git commit

	== S ==		== S ==
Line 57:		Line 61:

	; VCS		; VCS
	: a Version Control System, ~~like git~~, ~~subversion or mercurial~~		: acronym for Version Control System
			: Examples: Git, Subversion, Mercurial

NicolasDandrimont: Expand the glossary a bit

2016-06-10T15:18:05Z

Expand the glossary a bit

← Older revision		Revision as of 15:18, 10 June 2016
Line 1:		Line 1:
	This glossary contains the definition of common terms used in the Software Heritage project.		This glossary contains the definition of common terms used in the Software Heritage project.

			== C ==
	; Content		; Content
	: a file stored in the archive.		: a file stored in the archive, identified by its cryptographic hashes (SHA1, "git-like" SHA1, SHA256) and its size

			; Cryptographic hash
			: (also called Checksum, Digest) a fixed-size "summary" of a stream of bytes, that is easy to compute, and hard to reverse. ([https://en.wikipedia.org/wiki/Cryptographic_hash_function Cryptographic hash function Wikipedia article])

			== D ==

	; Directory		; Directory
			: a set of named pointers to files, directories and revisions

			== H ==

			; Hash
			: see Cryptographic hash

			== O ==

			; Origin
			: (also called Data sources) a location from which a coherent set of sources has been obtained.
			: Some examples of origins :
	:		:
			:* a [https://github.com/torvalds/linux/ git repository]
			:* a [https://www.kernel.org/pub/linux/kernel/v4.x/ directory containing tarballs]
			:* the history of a Debian package on [http://snapshot.debian.org/package/linux/ snapshot.debian.org].

	~~; Origin~~		== P ==
	~~: a location from which a coherent set of sources has been obtained.~~

	; Project		; Project
	:		:

			== R ==

	; Release		; Release
			: a revision that has been marked by a project as noteworthy with a specific, usually mnemonic, name (for instance, a version number).
			: Some examples of releases :
	:		:
			:* a git tag with its name
			:* a tarball with its name
			:* a Debian source package with its version number.

	; Revision		; Revision
			: a "point in time" snapshot in the development history of a project.
			: Some examples of revisions :
	:		:
			:* a git commit

			== S ==

			; SHA
			: (Secure Hash Algorithm) a family of Cryptographic hashes published by the NIST ([https://en.wikipedia.org/wiki/Secure_Hash_Algorithm SHA Wikipedia article])

			== V ==

	; VCS		; VCS
	: a Version Control System, like git, ~~svn~~ or hg		: a Version Control System, like git, subversion or mercurial

StefanoZacchiroli at 10:07, 7 April 2016

2016-04-07T10:07:34Z

← Older revision		Revision as of 10:07, 7 April 2016
Line 17:		Line 17:

	; Revision		; Revision
	:

	~~; Source~~
	:		:

	; VCS		; VCS
	: a Version Control System, like git, svn or hg		: a Version Control System, like git, svn or hg

StefanoZacchiroli: rename tree to directory (we don't use the former, it's git-specific terminology)

2016-04-07T10:06:52Z

rename tree to directory (we don't use the former, it's git-specific terminology)

← Older revision		Revision as of 10:06, 7 April 2016
Line 3:		Line 3:
	; Content		; Content
	: a file stored in the archive.		: a file stored in the archive.

			; Directory
			:

	; Origin		; Origin
Line 18:		Line 21:
	; Source		; Source
	:		:

	~~; Tree~~
	:

	; VCS		; VCS
	: a Version Control System, like git, svn or hg		: a Version Control System, like git, svn or hg

RobertoDiCosmo: Initialised the Glossary page

2016-04-07T09:49:56Z

Initialised the Glossary page

New page

This glossary contains the definition of common terms used in the Software Heritage project.

; Content
: a file stored in the archive.

; Origin
: a location from which a coherent set of sources has been obtained.

; Project
:

; Release
:

; Revision
:

; Source
:

; Tree
:

; VCS
: a Version Control System, like git, svn or hg