<feed xmlns='http://www.w3.org/2005/Atom'>
<title>git/Documentation/gittutorial-2.txt, branch v2.41.2</title>
<subtitle>Mirror of https://git.kernel.org/pub/scm/git/git.git/
</subtitle>
<id>https://git.shady.money/git/atom?h=v2.41.2</id>
<link rel='self' href='https://git.shady.money/git/atom?h=v2.41.2'/>
<link rel='alternate' type='text/html' href='https://git.shady.money/git/'/>
<updated>2019-05-07T04:04:48Z</updated>
<entry>
<title>doc: promote "git restore"</title>
<updated>2019-05-07T04:04:48Z</updated>
<author>
<name>Nguyễn Thái Ngọc Duy</name>
<email>pclouds@gmail.com</email>
</author>
<published>2019-04-25T09:45:58Z</published>
<link rel='alternate' type='text/html' href='https://git.shady.money/git/commit/?id=80f537f79c16efeb7b92b3409ede434a230b5679'/>
<id>urn:sha1:80f537f79c16efeb7b92b3409ede434a230b5679</id>
<content type='text'>
The new command "git restore" (together with "git switch") are added
to avoid the confusion of one-command-do-all "git checkout" for new
users. They are also helpful to avoid ambiguous context.

For these reasons, promote it everywhere possible. This includes
documentation, suggestions/advice from other commands.

One nice thing about git-restore is the ability to restore
"everything", so it can be used in "git status" advice instead of both
"git checkout" and "git reset".  The three commands suggested by "git
status" are add, rm and restore.

"git checkout" is also removed from "git help" (i.e. it's no longer
considered a commonly used command)

Signed-off-by: Nguyễn Thái Ngọc Duy &lt;pclouds@gmail.com&gt;
Signed-off-by: Junio C Hamano &lt;gitster@pobox.com&gt;
</content>
</entry>
<entry>
<title>Documentation: unify bottom "part of git suite" lines</title>
<updated>2017-02-09T23:14:01Z</updated>
<author>
<name>Stefan Beller</name>
<email>sbeller@google.com</email>
</author>
<published>2017-02-09T01:29:30Z</published>
<link rel='alternate' type='text/html' href='https://git.shady.money/git/commit/?id=941b9c527070c9c7b5883db1a7100559be571f71'/>
<id>urn:sha1:941b9c527070c9c7b5883db1a7100559be571f71</id>
<content type='text'>
We currently have 168 man pages that mention they are part of Git, you
can check yourself easily via:
  $ git grep "Part of the linkgit:git\[1\] suite" |wc -l
  168
However some have a trailing period, i.e.
  $ git grep "Part of the linkgit:git\[1\] suite." |wc -l
  8

Unify the bottom line in all man pages to not end with a period.

Signed-off-by: Stefan Beller &lt;sbeller@google.com&gt;
Signed-off-by: Junio C Hamano &lt;gitster@pobox.com&gt;
</content>
</entry>
<entry>
<title>Merge branch 'sn/tutorial-status-output-example'</title>
<updated>2014-11-19T21:47:59Z</updated>
<author>
<name>Junio C Hamano</name>
<email>gitster@pobox.com</email>
</author>
<published>2014-11-19T21:47:59Z</published>
<link rel='alternate' type='text/html' href='https://git.shady.money/git/commit/?id=eeb92d7e60d64c55cb6c766158dd078c905c95e0'/>
<id>urn:sha1:eeb92d7e60d64c55cb6c766158dd078c905c95e0</id>
<content type='text'>
* sn/tutorial-status-output-example:
  gittutorial: fix output of 'git status'
</content>
</entry>
<entry>
<title>gittutorial: fix output of 'git status'</title>
<updated>2014-11-13T18:53:50Z</updated>
<author>
<name>Stefan Naewe</name>
<email>stefan.naewe@gmail.com</email>
</author>
<published>2014-11-13T10:40:07Z</published>
<link rel='alternate' type='text/html' href='https://git.shady.money/git/commit/?id=8942821ec046238b6cea12e6dd4dfa7ba51c133e'/>
<id>urn:sha1:8942821ec046238b6cea12e6dd4dfa7ba51c133e</id>
<content type='text'>
'git status' doesn't output leading '#'s these days.

Signed-off-by: Stefan Naewe &lt;stefan.naewe@gmail.com&gt;
Signed-off-by: Junio C Hamano &lt;gitster@pobox.com&gt;
</content>
</entry>
<entry>
<title>doc: add 'everyday' to 'git help'</title>
<updated>2014-10-10T23:02:26Z</updated>
<author>
<name>Philip Oakley</name>
<email>philipoakley@iee.org</email>
</author>
<published>2014-10-10T21:25:37Z</published>
<link rel='alternate' type='text/html' href='https://git.shady.money/git/commit/?id=673151a9bb56ec97fab66746e3aecef78fddb9b8'/>
<id>urn:sha1:673151a9bb56ec97fab66746e3aecef78fddb9b8</id>
<content type='text'>
The "Everyday GIT With 20 Commands Or So" is not accessible via the
Git help system.  Move everyday.txt to giteveryday.txt so that "git
help everyday" works, and create a new placeholder file everyday.html
to refer people who follow existing URLs to the updated location.

giteveryday.txt now formats well with AsciiDoc as a man page and
refreshed content to a more command modern style.

Add 'everyday' to the help --guides list and update git(1) and 5
other links to giteveryday.

Signed-off-by: Philip Oakley &lt;philipoakley@iee.org&gt;
Signed-off-by: Junio C Hamano &lt;gitster@pobox.com&gt;
</content>
</entry>
<entry>
<title>The name of the hash function is "SHA-1", not "SHA1"</title>
<updated>2013-04-15T18:08:37Z</updated>
<author>
<name>Thomas Ackermann</name>
<email>th.acker@arcor.de</email>
</author>
<published>2013-04-15T17:49:04Z</published>
<link rel='alternate' type='text/html' href='https://git.shady.money/git/commit/?id=d5fa1f1a69f578831179b77893aac480b986e875'/>
<id>urn:sha1:d5fa1f1a69f578831179b77893aac480b986e875</id>
<content type='text'>
Use "SHA-1" instead of "SHA1" whenever we talk about the hash function.
When used as a programming symbol, we keep "SHA1".

Signed-off-by: Thomas Ackermann &lt;th.acker@arcor.de&gt;
Signed-off-by: Junio C Hamano &lt;gitster@pobox.com&gt;
</content>
</entry>
<entry>
<title>Documentation: the name of the system is 'Git', not 'git'</title>
<updated>2013-02-01T21:53:33Z</updated>
<author>
<name>Thomas Ackermann</name>
<email>th.acker@arcor.de</email>
</author>
<published>2013-01-21T19:17:53Z</published>
<link rel='alternate' type='text/html' href='https://git.shady.money/git/commit/?id=2de9b71138171dca7279db3b3fe67e868c76d921'/>
<id>urn:sha1:2de9b71138171dca7279db3b3fe67e868c76d921</id>
<content type='text'>
Signed-off-by: Thomas Ackermann &lt;th.acker@arcor.de&gt;
Signed-off-by: Junio C Hamano &lt;gitster@pobox.com&gt;
</content>
</entry>
<entry>
<title>Use correct grammar in diffstat summary line</title>
<updated>2012-02-04T07:19:42Z</updated>
<author>
<name>Nguyễn Thái Ngọc Duy</name>
<email>pclouds@gmail.com</email>
</author>
<published>2012-02-01T12:55:07Z</published>
<link rel='alternate' type='text/html' href='https://git.shady.money/git/commit/?id=7f814632f5d4d7af9f4225ece6039dbc44e03079'/>
<id>urn:sha1:7f814632f5d4d7af9f4225ece6039dbc44e03079</id>
<content type='text'>
"git diff --stat" and "git apply --stat" now learn to print the line
"%d files changed, %d insertions(+), %d deletions(-)" in singular form
whenever applicable. "0 insertions" and "0 deletions" are also omitted
unless they are both zero.

This matches how versions of "diffstat" that are not prehistoric produced
their output, and also makes this line translatable.

[jc: with help from Thomas Dickey in archaeology of "diffstat"]
[jc: squashed Jonathan's updates to illustrations in tutorials and a test]

Signed-off-by: Nguyễn Thái Ngọc Duy &lt;pclouds@gmail.com&gt;
Signed-off-by: Jonathan Nieder &lt;jrnieder@gmail.com&gt;
Signed-off-by: Junio C Hamano &lt;gitster@pobox.com&gt;
</content>
</entry>
<entry>
<title>Documentation: use [verse] for SYNOPSIS sections</title>
<updated>2011-07-06T21:26:26Z</updated>
<author>
<name>Martin von Zweigbergk</name>
<email>martin.von.zweigbergk@gmail.com</email>
</author>
<published>2011-07-02T02:38:26Z</published>
<link rel='alternate' type='text/html' href='https://git.shady.money/git/commit/?id=7791a1d9b9a4f4e15662c7c9c7f5837f461bb987'/>
<id>urn:sha1:7791a1d9b9a4f4e15662c7c9c7f5837f461bb987</id>
<content type='text'>
The SYNOPSIS sections of most commands that span several lines already
use [verse] to retain line breaks. Most commands that don't span
several lines seem not to use [verse]. In the HTML output, [verse]
does not only preserve line breaks, but also makes the section
indented, which causes a slight inconsistency between commands that
use [verse] and those that don't. Use [verse] in all SYNOPSIS sections
for consistency.

Also remove the blank lines from git-fetch.txt and git-rebase.txt to
align with the other man pages. In the case of git-rebase.txt, which
already uses [verse], the blank line makes the [verse] not apply to
the last line, so removing the blank line also makes the formatting
within the document more consistent.

While at it, add single quotes to 'git cvsimport' for consistency with
other commands.

Signed-off-by: Martin von Zweigbergk &lt;martin.von.zweigbergk@gmail.com&gt;
Signed-off-by: Junio C Hamano &lt;gitster@pobox.com&gt;
</content>
</entry>
<entry>
<title>Better "Changed but not updated" message in git-status</title>
<updated>2010-11-03T16:18:58Z</updated>
<author>
<name>Matthieu Moy</name>
<email>Matthieu.Moy@imag.fr</email>
</author>
<published>2010-11-02T15:31:19Z</published>
<link rel='alternate' type='text/html' href='https://git.shady.money/git/commit/?id=8009d83c7e7af0a298ef858609a8201d01086396'/>
<id>urn:sha1:8009d83c7e7af0a298ef858609a8201d01086396</id>
<content type='text'>
Older Gits talked about "updating" a file to add its content to the
index, but this terminology is confusing for new users. "to stage" is far
more intuitive and already used in e.g. the "git stage" command name.

Signed-off-by: Matthieu Moy &lt;Matthieu.Moy@imag.fr&gt;
Signed-off-by: Junio C Hamano &lt;gitster@pobox.com&gt;
</content>
</entry>
</feed>
