| blob | d1b52d02a49814c7b902ace1505b824216342fee |
4 <head>
9 /* Debug borders */
11 /*
12 border: 1px solid red;
13 */
14 }
16 body {
18 }
20 a {
23 }
26 }
28 em {
31 }
33 strong {
36 }
38 tt {
40 }
48 }
52 }
53 h2 {
55 }
56 h3 {
58 }
59 h3 + * {
61 }
66 }
68 hr {
70 }
72 p {
75 }
79 }
81 pre {
84 }
86 span#author {
91 }
92 span#email {
93 }
96 }
98 div#footer {
104 }
105 div#footer-text {
108 }
109 div#footer-badges {
112 }
114 div#preamble {
117 }
123 }
127 }
131 }
133 /* Block element titles. */
141 }
144 }
148 }
151 }
154 }
160 }
166 }
171 }
175 }
180 }
183 }
187 }
188 /* DEPRECATED: Pre version 8.2.7 verse style literal block. */
191 }
200 }
204 }
209 }
215 dl {
218 }
219 dt {
224 }
227 }
231 }
234 }
237 }
240 }
243 }
246 }
253 }
257 }
258 thead {
261 }
262 tfoot {
264 }
267 }
270 }
271 /* Because the table frame attribute is overriden by CSS in most browsers. */
274 }
278 }
282 }
288 }
291 }
294 }
300 }
303 }
307 }
311 }
315 }
317 div#toctitle {
324 }
329 }
333 }
337 }
341 }
342 /* Overrides for manpage documents */
343 h1 {
348 }
349 h2 {
351 }
354 }
358 }
360 /* Workarounds for IE6's broken and incomplete CSS2. */
366 }
373 }
379 }
384 }
388 }
392 }
397 }
399 /* IE6 sets dynamically generated links as visited. */
401 </style>
402 </head>
403 <body>
405 <h1>
406 git-clone(1) Manual Page
407 </h1>
410 <p>git-clone -
411 Clone a repository into a new directory
412 </p>
413 </div>
414 </div>
419 [-l] [-s] [--no-hardlinks] [-q] [-n] [--bare] [--mirror]
425 </div></div>
426 </div>
430 remote-tracking branches for each branch in the cloned repository
432 initial branch that is forked from the cloned repository’s
433 currently active branch.</p></div>
434 <div class="paragraph"><p>After the clone, a plain <tt>git fetch</tt> without arguments will update
436 arguments will in addition merge the remote master branch into the
437 current master branch, if any.</p></div>
441 configuration variables.</p></div>
442 </div>
447 --local
448 </dt>
450 -l
451 </dt>
452 <dd>
453 <p>
454 When the repository to clone from is on a local machine,
455 this flag bypasses the normal "git aware" transport
456 mechanism and clones the repository by making a copy of
457 HEAD and everything under objects and refs directories.
459 to save space when possible. This is now the default when
461 syntax, so it essentially is a no-op option. To force
462 copying instead of hardlinking (which may be desirable
463 if you are trying to make a back-up of your repository),
464 but still avoid the usual "git aware" transport
466 </p>
467 </dd>
469 --no-hardlinks
470 </dt>
471 <dd>
472 <p>
473 Optimize the cloning process from a repository on a
475 directory.
476 </p>
477 </dd>
479 --shared
480 </dt>
482 -s
483 </dt>
484 <dd>
485 <p>
486 When the repository to clone is on the local machine,
487 instead of using hard links, automatically setup
489 with the source repository. The resulting repository
490 starts out without any object of its own.
491 </p>
492 <div class="paragraph"><p><strong>NOTE</strong>: this is a possibly dangerous operation; do <strong>not</strong> use
493 it unless you understand what it does. If you clone your
494 repository using this option and then delete branches (or use any
495 other git command that makes any existing commit unreferenced) in the
496 source repository, some objects may become unreferenced (or dangling).
499 If these objects are removed and were referenced by the cloned repository,
500 then the cloned repository will become corrupt.</p></div>
501 <div class="paragraph"><p>Note that running <tt>git repack</tt> without the <tt>-l</tt> option in a repository
505 default.</p></div>
506 <div class="paragraph"><p>If you want to break the dependency of a repository cloned with <tt>-s</tt> on
508 objects from the source repository into a pack in the cloned repository.</p></div>
509 </dd>
512 </dt>
513 <dd>
514 <p>
515 If the reference repository is on the local machine,
517 obtain objects from the reference repository. Using
518 an already existing repository as an alternate will
519 require fewer objects to be copied from the repository
520 being cloned, reducing network and local storage costs.
521 </p>
522 <div class="paragraph"><p><strong>NOTE</strong>: see the NOTE for the <tt>--shared</tt> option.</p></div>
523 </dd>
525 --quiet
526 </dt>
528 -q
529 </dt>
530 <dd>
531 <p>
532 Operate quietly. Progress is not reported to the standard
534 command when given.
535 </p>
536 </dd>
538 --verbose
539 </dt>
541 -v
542 </dt>
543 <dd>
544 <p>
545 Run verbosely. Does not affect the reporting of progress status
546 to the standard error stream.
547 </p>
548 </dd>
550 --progress
551 </dt>
552 <dd>
553 <p>
554 Progress status is reported on the standard error stream
555 by default when it is attached to a terminal, unless -q
556 is specified. This flag forces progress status even if the
557 standard error stream is not directed to a terminal.
558 </p>
559 </dd>
561 --no-checkout
562 </dt>
564 -n
565 </dt>
566 <dd>
567 <p>
568 No checkout of HEAD is performed after the clone is complete.
569 </p>
570 </dd>
572 --bare
573 </dt>
574 <dd>
575 <p>
580 because there is nowhere to check out the working tree.
581 Also the branch heads at the remote are copied directly
582 to corresponding local branch heads, without mapping
584 used, neither remote-tracking branches nor the related
585 configuration variables are created.
586 </p>
587 </dd>
589 --mirror
590 </dt>
591 <dd>
592 <p>
595 source to local branches of the target, it maps all refs (including
596 remote-tracking branches, notes etc.) and sets up a refspec configuration such
598 target repository.
599 </p>
600 </dd>
603 </dt>
606 </dt>
607 <dd>
608 <p>
611 </p>
612 </dd>
615 </dt>
618 </dt>
619 <dd>
620 <p>
621 Instead of pointing the newly created HEAD to the branch pointed
623 instead. In a non-bare repository, this is the branch that will
624 be checked out.
625 </p>
626 </dd>
629 </dt>
632 </dt>
633 <dd>
634 <p>
635 When given, and the repository to clone from is accessed
636 via ssh, this specifies a non-default path for the command
637 run on the other end.
638 </p>
639 </dd>
642 </dt>
643 <dd>
644 <p>
645 Specify the directory from which templates will be used;
647 </p>
648 </dd>
651 </dt>
652 <dd>
653 <p>
655 specified number of revisions. A shallow repository has a
656 number of limitations (you cannot clone or fetch from
657 it, nor push from nor into it), but is adequate if you
658 are only interested in the recent history of a large project
659 with a long history, and would want to send in fixes
660 as patches.
661 </p>
662 </dd>
664 --recursive
665 </dt>
667 --recurse-submodules
668 </dt>
669 <dd>
670 <p>
671 After the clone is created, initialize all submodules within,
672 using their default settings. This is equivalent to running
674 the clone is finished. This option is ignored if the cloned
675 repository does not have a worktree/checkout (i.e. if any of
677 </p>
678 </dd>
681 </dt>
684 </dt>
685 <dd>
686 <p>
687 Instead of placing the cloned repository where it is supposed
688 to be, place the cloned repository at the specified directory,
689 then make a filesytem-agnostic git symbolic link to there.
690 The result is git repository can be separated from working
691 tree.
692 </p>
693 </dd>
696 </dt>
697 <dd>
698 <p>
699 The (possibly remote) repository to clone from. See the
701 repositories.
702 </p>
703 </dd>
706 </dt>
707 <dd>
708 <p>
709 The name of a new directory to clone into. The "humanish"
710 part of the source repository is used if no directory is
713 is only allowed if the directory is empty.
714 </p>
715 </dd>
716 </dl></div>
717 </div>
720 <div class="paragraph"><p>In general, URLs contain information about the transport protocol, the
721 address of the remote server, and the path to the repository.
722 Depending on the transport protocol, some of this information may be
723 absent.</p></div>
725 protocols. The following syntaxes may be used with them:</p></div>
727 <li>
728 <p>
730 </p>
731 </li>
732 <li>
733 <p>
735 </p>
736 </li>
737 <li>
738 <p>
740 </p>
741 </li>
742 <li>
743 <p>
745 </p>
746 </li>
747 <li>
748 <p>
749 rsync://host.xz/path/to/repo.git/
750 </p>
751 </li>
752 </ul></div>
753 <div class="paragraph"><p>An alternative scp-like syntax may also be used with the ssh protocol:</p></div>
755 <li>
756 <p>
758 </p>
759 </li>
760 </ul></div>
761 <div class="paragraph"><p>The ssh and git protocols additionally support ~username expansion:</p></div>
763 <li>
764 <p>
766 </p>
767 </li>
768 <li>
769 <p>
771 </p>
772 </li>
773 <li>
774 <p>
776 </p>
777 </li>
778 </ul></div>
780 syntaxes may be used:</p></div>
782 <li>
783 <p>
784 /path/to/repo.git/
785 </p>
786 </li>
787 <li>
788 <p>
790 </p>
791 </li>
792 </ul></div>
794 --local option.</p></div>
795 <div class="paragraph"><p>When git doesn’t know how to handle a certain transport protocol, it
797 exists. To explicitly request a remote helper, the following syntax
798 may be used:</p></div>
800 <li>
801 <p>
803 </p>
804 </li>
805 </ul></div>
806 <div class="paragraph"><p>where <address> may be a path, a server and path, or an arbitrary
807 URL-like string recognized by the specific remote helper being
809 <div class="paragraph"><p>If there are a large number of similarly-named remote repositories and
810 you want to use a different format for them (such that the URLs you
811 use will be rewritten into URLs that work), you can create a
812 configuration section of the form:</p></div>
817 </div></div>
822 insteadOf = host.xz:/path/to/
823 insteadOf = work:</tt></pre>
824 </div></div>
825 <div class="paragraph"><p>a URL like "work:repo.git" or like "host.xz:/path/to/repo.git" will be
828 configuration section of the form:</p></div>
833 </div></div>
838 pushInsteadOf = git://example.org/</tt></pre>
839 </div></div>
841 "ssh://example.org/path/to/repo.git" for pushes, but pulls will still
842 use the original URL.</p></div>
843 </div>
847 <li>
848 <p>
849 Clone from upstream:
850 </p>
854 $ cd my2.6
855 $ make</tt></pre>
856 </div></div>
857 </li>
858 <li>
859 <p>
860 Make a local clone that borrows from the current directory, without checking things out:
861 </p>
864 <pre><tt>$ git clone -l -s -n . ../copy
865 $ cd ../copy
866 $ git show-branch</tt></pre>
867 </div></div>
868 </li>
869 <li>
870 <p>
871 Clone from upstream while borrowing from an existing local directory:
872 </p>
875 <pre><tt>$ git clone --reference my2.6 \
876 git://git.kernel.org/pub/scm/.../linux-2.7 \
877 my2.7
878 $ cd my2.7</tt></pre>
879 </div></div>
880 </li>
881 <li>
882 <p>
883 Create a bare repository to publish your changes to the public:
884 </p>
888 </div></div>
889 </li>
890 <li>
891 <p>
892 Create a repository on the kernel.org machine that borrows from Linus:
893 </p>
898 </div></div>
899 </li>
900 </ul></div>
901 </div>
905 </div>
909 </div>
910 </div>
911 </body>
912 </html>