[PATCH User manual-Added advice on proxies and autocrlf]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



---
 Documentation/user-manual.txt |   23 +++++++++++++++++++++++
 1 files changed, 23 insertions(+), 0 deletions(-)

diff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt
index bfde507..02b1be0 100644
--- a/Documentation/user-manual.txt
+++ b/Documentation/user-manual.txt
@@ -56,6 +56,16 @@ $ git clone
git://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux-2.6.git
 The initial clone may be time-consuming for a large project, but you
 will only need to clone once.

+If there is a proxy between you and the repository you want to clone, you
+may not be able to use the git protocol. But you can use the http protocol, by
+configuring the proxy. Note that the address to access the repository via http
+may be different from the git address:
+
+------------------------------------------------
+$ export http_proxy=http://theproxy.example.com:8080
+$ git clone http://www.kernel.org/pub/scm/git/git.git
+------------------------------------------------
+
 The clone command creates a new directory named after the project ("git"
 or "linux-2.6" in the examples above).  After you cd into this
 directory, you will see that it contains a copy of the project files,
@@ -129,6 +139,19 @@ $ git branch
 * new
 ------------------------------------------------

+It is possible, particularly on Windows platforms, that as you checkout
+the original version, it will in fact be modified, by the autocrlf process.
+(Windows and Unix store newlines as CRLF and LF respectively, and autocrlf
+tries to adapt intelligently.) If the checked out version is modified, then
+trying to switch to a new branch will not work, because then the uncommitted
+changes would be lost. So you may need to add the +-f+ flag to _force_ these
+changes to be thrown away. Another option might be to edit +~/.gitconfig+ or
+use the following command to disable the autocrlf function.
+
+------------------------------------------------
++git config --global core.autocrlf false
+------------------------------------------------
+
 If you decide that you'd rather see version 2.6.17, you can modify
 the current branch to point at v2.6.17 instead, with

-- 
1.5.5.1015.g9d258
--
To unsubscribe from this list: send the line "unsubscribe git" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html

[Index of Archives]     [Linux Kernel Development]     [Gcc Help]     [IETF Annouce]     [DCCP]     [Netdev]     [Networking]     [Security]     [V4L]     [Bugtraq]     [Yosemite]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Linux SCSI]     [Fedora Users]

  Powered by Linux