glossary.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"\r
   2     "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">\r
   3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">\r
   4 <head>\r
   5 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />\r
   6 <meta name="generator" content="AsciiDoc 7.0.1" />\r
   7 <style type="text/css">\r
   8 /* Debug borders */\r
   9 p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {\r
  10 /*\r
  11   border: 1px solid red;\r
  12 */\r
  13 }\r
  14 \r
  15 body {\r
  16   margin: 1em 5% 1em 5%;\r
  17 }\r
  18 \r
  19 a { color: blue; }\r
  20 a:visited { color: fuchsia; }\r
  21 \r
  22 em {\r
  23   font-style: italic;\r
  24 }\r
  25 \r
  26 strong {\r
  27   font-weight: bold;\r
  28 }\r
  29 \r
  30 tt {\r
  31   color: navy;\r
  32 }\r
  33 \r
  34 h1, h2, h3, h4, h5, h6 {\r
  35   color: #527bbd;\r
  36   font-family: sans-serif;\r
  37   margin-top: 1.2em;\r
  38   margin-bottom: 0.5em;\r
  39   line-height: 1.3;\r
  40 }\r
  41 \r
  42 h1 {\r
  43   border-bottom: 2px solid silver;\r
  44 }\r
  45 h2 {\r
  46   border-bottom: 2px solid silver;\r
  47   padding-top: 0.5em;\r
  48 }\r
  49 \r
  50 div.sectionbody {\r
  51   font-family: serif;\r
  52   margin-left: 0;\r
  53 }\r
  54 \r
  55 hr {\r
  56   border: 1px solid silver;\r
  57 }\r
  58 \r
  59 p {\r
  60   margin-top: 0.5em;\r
  61   margin-bottom: 0.5em;\r
  62 }\r
  63 \r
  64 pre {\r
  65   padding: 0;\r
  66   margin: 0;\r
  67 }\r
  68 \r
  69 span#author {\r
  70   color: #527bbd;\r
  71   font-family: sans-serif;\r
  72   font-weight: bold;\r
  73   font-size: 1.2em;\r
  74 }\r
  75 span#email {\r
  76 }\r
  77 span#revision {\r
  78   font-family: sans-serif;\r
  79 }\r
  80 \r
  81 div#footer {\r
  82   font-family: sans-serif;\r
  83   font-size: small;\r
  84   border-top: 2px solid silver;\r
  85   padding-top: 0.5em;\r
  86   margin-top: 4.0em;\r
  87 }\r
  88 div#footer-text {\r
  89   float: left;\r
  90   padding-bottom: 0.5em;\r
  91 }\r
  92 div#footer-badges {\r
  93   float: right;\r
  94   padding-bottom: 0.5em;\r
  95 }\r
  96 \r
  97 div#preamble,\r
  98 div.tableblock, div.imageblock, div.exampleblock, div.verseblock,\r
  99 div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,\r
 100 div.admonitionblock {\r
 101   margin-right: 10%;\r
 102   margin-top: 1.5em;\r
 103   margin-bottom: 1.5em;\r
 104 }\r
 105 div.admonitionblock {\r
 106   margin-top: 2.5em;\r
 107   margin-bottom: 2.5em;\r
 108 }\r
 109 \r
 110 div.content { /* Block element content. */\r
 111   padding: 0;\r
 112 }\r
 113 \r
 114 /* Block element titles. */\r
 115 div.title, caption.title {\r
 116   font-family: sans-serif;\r
 117   font-weight: bold;\r
 118   text-align: left;\r
 119   margin-top: 1.0em;\r
 120   margin-bottom: 0.5em;\r
 121 }\r
 122 div.title + * {\r
 123   margin-top: 0;\r
 124 }\r
 125 \r
 126 td div.title:first-child {\r
 127   margin-top: 0.0em;\r
 128 }\r
 129 div.content div.title:first-child {\r
 130   margin-top: 0.0em;\r
 131 }\r
 132 div.content + div.title {\r
 133   margin-top: 0.0em;\r
 134 }\r
 135 \r
 136 div.sidebarblock > div.content {\r
 137   background: #ffffee;\r
 138   border: 1px solid silver;\r
 139   padding: 0.5em;\r
 140 }\r
 141 \r
 142 div.listingblock > div.content {\r
 143   border: 1px solid silver;\r
 144   background: #f4f4f4;\r
 145   padding: 0.5em;\r
 146 }\r
 147 \r
 148 div.quoteblock > div.content {\r
 149   padding-left: 2.0em;\r
 150 }\r
 151 div.quoteblock .attribution {\r
 152   text-align: right;\r
 153 }\r
 154 \r
 155 div.admonitionblock .icon {\r
 156   vertical-align: top;\r
 157   font-size: 1.1em;\r
 158   font-weight: bold;\r
 159   text-decoration: underline;\r
 160   color: #527bbd;\r
 161   padding-right: 0.5em;\r
 162 }\r
 163 div.admonitionblock td.content {\r
 164   padding-left: 0.5em;\r
 165   border-left: 2px solid silver;\r
 166 }\r
 167 \r
 168 div.exampleblock > div.content {\r
 169   border-left: 2px solid silver;\r
 170   padding: 0.5em;\r
 171 }\r
 172 \r
 173 div.verseblock div.content {\r
 174   white-space: pre;\r
 175 }\r
 176 \r
 177 div.imageblock div.content { padding-left: 0; }\r
 178 div.imageblock img { border: 1px solid silver; }\r
 179 span.image img { border-style: none; }\r
 180 \r
 181 dl {\r
 182   margin-top: 0.8em;\r
 183   margin-bottom: 0.8em;\r
 184 }\r
 185 dt {\r
 186   margin-top: 0.5em;\r
 187   margin-bottom: 0;\r
 188   font-style: italic;\r
 189 }\r
 190 dd > *:first-child {\r
 191   margin-top: 0;\r
 192 }\r
 193 \r
 194 ul, ol {\r
 195     list-style-position: outside;\r
 196 }\r
 197 ol.olist2 {\r
 198   list-style-type: lower-alpha;\r
 199 }\r
 200 \r
 201 div.tableblock > table {\r
 202   border-color: #527bbd;\r
 203   border-width: 3px;\r
 204 }\r
 205 thead {\r
 206   font-family: sans-serif;\r
 207   font-weight: bold;\r
 208 }\r
 209 tfoot {\r
 210   font-weight: bold;\r
 211 }\r
 212 \r
 213 div.hlist {\r
 214   margin-top: 0.8em;\r
 215   margin-bottom: 0.8em;\r
 216 }\r
 217 td.hlist1 {\r
 218   vertical-align: top;\r
 219   font-style: italic;\r
 220   padding-right: 0.8em;\r
 221 }\r
 222 td.hlist2 {\r
 223   vertical-align: top;\r
 224 }\r
 225 \r
 226 @media print {\r
 227   div#footer-badges { display: none; }\r
 228 }\r
 229 /* Workarounds for IE6's broken and incomplete CSS2. */\r
 230 \r
 231 div.sidebar-content {\r
 232   background: #ffffee;\r
 233   border: 1px solid silver;\r
 234   padding: 0.5em;\r
 235 }\r
 236 div.sidebar-title, div.image-title {\r
 237   font-family: sans-serif;\r
 238   font-weight: bold;\r
 239   margin-top: 0.0em;\r
 240   margin-bottom: 0.5em;\r
 241 }\r
 242 \r
 243 div.listingblock div.content {\r
 244   border: 1px solid silver;\r
 245   background: #f4f4f4;\r
 246   padding: 0.5em;\r
 247 }\r
 248 \r
 249 div.quoteblock-content {\r
 250   padding-left: 2.0em;\r
 251 }\r
 252 \r
 253 div.exampleblock-content {\r
 254   border-left: 2px solid silver;\r
 255   padding-left: 0.5em;\r
 256 }\r
 257 </style>\r
 258 <title>GIT Glossary</title>\r
 259 </head>\r
 260 <body>\r
 261 <div id="header">\r
 262 <h1>GIT Glossary</h1>\r
 263 </div>\r
 264 <div id="preamble">\r
 265 <div class="sectionbody">\r
 266 <p>This list is sorted alphabetically:</p>\r
 267 <dl>\r
 268 <dt>\r
 269 <a id="ref_alternate_object_database"></a>alternate object database\r
 270 </dt>\r
 271 <dd>\r
 272 <p>\r
 273         Via the alternates mechanism, a <a href="#ref_repository">repository</a> can\r
 274         inherit part of its <a href="#ref_object_database">object database</a> from another\r
 275         <a href="#ref_object_database">object database</a>, which is called "alternate".\r
 276 </p>\r
 277 </dd>\r
 278 <dt>\r
 279 <a id="ref_blob_object"></a>blob object\r
 280 </dt>\r
 281 <dd>\r
 282 <p>\r
 283         Untyped <a href="#ref_object">object</a>, e.g. the contents of a file.\r
 284 </p>\r
 285 </dd>\r
 286 <dt>\r
 287 <a id="ref_branch"></a>branch\r
 288 </dt>\r
 289 <dd>\r
 290 <p>\r
 291         A non-cyclical graph of revisions, i.e. the complete history of a\r
 292         particular <a href="#ref_revision">revision</a>, which is called the\r
 293         <a href="#ref_branch">branch</a> <a href="#ref_head">head</a>. The <a href="#ref_branch">branch</a> heads\r
 294         are stored in <tt>$GIT_DIR/refs/heads/</tt>.\r
 295 </p>\r
 296 </dd>\r
 297 <dt>\r
 298 <a id="ref_cache"></a>cache\r
 299 </dt>\r
 300 <dd>\r
 301 <p>\r
 302         Obsolete for: <a href="#ref_index">index</a>.\r
 303 </p>\r
 304 </dd>\r
 305 <dt>\r
 306 <a id="ref_chain"></a>chain\r
 307 </dt>\r
 308 <dd>\r
 309 <p>\r
 310         A list of objects, where each <a href="#ref_object">object</a> in the list contains\r
 311         a reference to its successor (for example, the successor of a\r
 312         <a href="#ref_commit">commit</a> could be one of its parents).\r
 313 </p>\r
 314 </dd>\r
 315 <dt>\r
 316 <a id="ref_changeset"></a>changeset\r
 317 </dt>\r
 318 <dd>\r
 319 <p>\r
 320         BitKeeper/cvsps speak for "<a href="#ref_commit">commit</a>". Since git does not\r
 321         store changes, but states, it really does not make sense to use the term\r
 322         "changesets" with git.\r
 323 </p>\r
 324 </dd>\r
 325 <dt>\r
 326 <a id="ref_checkout"></a>checkout\r
 327 </dt>\r
 328 <dd>\r
 329 <p>\r
 330         The action of updating the <a href="#ref_working_tree">working tree</a> to a\r
 331         <a href="#ref_revision">revision</a> which was stored in the\r
 332         <a href="#ref_object_database">object database</a>.\r
 333 </p>\r
 334 </dd>\r
 335 <dt>\r
 336 <a id="ref_clean"></a>clean\r
 337 </dt>\r
 338 <dd>\r
 339 <p>\r
 340         A <a href="#ref_working_tree">working tree</a> is <a href="#ref_clean">clean</a>, if it\r
 341         corresponds to the <a href="#ref_revision">revision</a> referenced by the current\r
 342         <a href="#ref_head">head</a>.\r
 343 </p>\r
 344 </dd>\r
 345 <dt>\r
 346 <a id="ref_commit"></a>commit\r
 347 </dt>\r
 348 <dd>\r
 349 <p>\r
 350         As a verb: The action of storing the current state of the\r
 351         <a href="#ref_index">index</a> in the <a href="#ref_object_database">object database</a>. The\r
 352         result is a <a href="#ref_revision">revision</a>. As a noun: Short hand for\r
 353         <a href="#ref_commit_object">commit object</a>.\r
 354 </p>\r
 355 </dd>\r
 356 <dt>\r
 357 <a id="ref_commit_object"></a>commit object\r
 358 </dt>\r
 359 <dd>\r
 360 <p>\r
 361         An <a href="#ref_object">object</a> which contains the information about a\r
 362         particular <a href="#ref_revision">revision</a>, such as parents, committer,\r
 363         author, date and the <a href="#ref_tree_object">tree object</a> which corresponds\r
 364         to the top <a href="#ref_directory">directory</a> of the stored\r
 365         <a href="#ref_revision">revision</a>.\r
 366 </p>\r
 367 </dd>\r
 368 <dt>\r
 369 <a id="ref_core_git"></a>core git\r
 370 </dt>\r
 371 <dd>\r
 372 <p>\r
 373         Fundamental data structures and utilities of git. Exposes only limited\r
 374         source code management tools.\r
 375 </p>\r
 376 </dd>\r
 377 <dt>\r
 378 <a id="ref_DAG"></a>DAG\r
 379 </dt>\r
 380 <dd>\r
 381 <p>\r
 382         Directed acyclic graph. The <a href="#ref_commit">commit</a> objects form a\r
 383         directed acyclic graph, because they have parents (directed), and the\r
 384         graph of <a href="#ref_commit">commit</a> objects is acyclic (there is no\r
 385         <a href="#ref_chain">chain</a> which begins and ends with the same\r
 386         <a href="#ref_object">object</a>).\r
 387 </p>\r
 388 </dd>\r
 389 <dt>\r
 390 <a id="ref_dircache"></a>dircache\r
 391 </dt>\r
 392 <dd>\r
 393 <p>\r
 394         You are <strong>waaaaay</strong> behind.\r
 395 </p>\r
 396 </dd>\r
 397 <dt>\r
 398 <a id="ref_directory"></a>directory\r
 399 </dt>\r
 400 <dd>\r
 401 <p>\r
 402         The list you get with "ls" :-)\r
 403 </p>\r
 404 </dd>\r
 405 <dt>\r
 406 <a id="ref_dirty"></a>dirty\r
 407 </dt>\r
 408 <dd>\r
 409 <p>\r
 410         A <a href="#ref_working_tree">working tree</a> is said to be <a href="#ref_dirty">dirty</a> if\r
 411         it contains modifications which have not been committed to the current\r
 412         <a href="#ref_branch">branch</a>.\r
 413 </p>\r
 414 </dd>\r
 415 <dt>\r
 416 <a id="ref_ent"></a>ent\r
 417 </dt>\r
 418 <dd>\r
 419 <p>\r
 420         Favorite synonym to "<a href="#ref_tree-ish">tree-ish</a>" by some total geeks. See\r
 421         <tt>http://en.wikipedia.org/wiki/Ent_(Middle-earth)</tt> for an in-depth\r
 422         explanation.\r
 423 </p>\r
 424 </dd>\r
 425 <dt>\r
 426 <a id="ref_fetch"></a>fetch\r
 427 </dt>\r
 428 <dd>\r
 429 <p>\r
 430         Fetching a <a href="#ref_branch">branch</a> means to get the\r
 431         <a href="#ref_branch">branch</a>'s <a href="#ref_head_ref">head ref</a> from a remote\r
 432         <a href="#ref_repository">repository</a>, to find out which objects are missing\r
 433         from the local <a href="#ref_object_database">object database</a>, and to get them,\r
 434         too.\r
 435 </p>\r
 436 </dd>\r
 437 <dt>\r
 438 <a id="ref_file_system"></a>file system\r
 439 </dt>\r
 440 <dd>\r
 441 <p>\r
 442         Linus Torvalds originally designed git to be a user space file system,\r
 443         i.e. the infrastructure to hold files and directories. That ensured the\r
 444         efficiency and speed of git.\r
 445 </p>\r
 446 </dd>\r
 447 <dt>\r
 448 <a id="ref_git_archive"></a>git archive\r
 449 </dt>\r
 450 <dd>\r
 451 <p>\r
 452         Synonym for <a href="#ref_repository">repository</a> (for arch people).\r
 453 </p>\r
 454 </dd>\r
 455 <dt>\r
 456 <a id="ref_hash"></a>hash\r
 457 </dt>\r
 458 <dd>\r
 459 <p>\r
 460         In git's context, synonym to <a href="#ref_object_name">object name</a>.\r
 461 </p>\r
 462 </dd>\r
 463 <dt>\r
 464 <a id="ref_head"></a>head\r
 465 </dt>\r
 466 <dd>\r
 467 <p>\r
 468         The top of a <a href="#ref_branch">branch</a>. It contains a <a href="#ref_ref">ref</a> to the\r
 469         corresponding <a href="#ref_commit_object">commit object</a>.\r
 470 </p>\r
 471 </dd>\r
 472 <dt>\r
 473 <a id="ref_head_ref"></a>head ref\r
 474 </dt>\r
 475 <dd>\r
 476 <p>\r
 477         A <a href="#ref_ref">ref</a> pointing to a <a href="#ref_head">head</a>. Often, this is\r
 478         abbreviated to "<a href="#ref_head">head</a>". Head refs are stored in\r
 479         <tt>$GIT_DIR/refs/heads/</tt>.\r
 480 </p>\r
 481 </dd>\r
 482 <dt>\r
 483 <a id="ref_index"></a>index\r
 484 </dt>\r
 485 <dd>\r
 486 <p>\r
 487         A collection of files with stat information, whose contents are stored\r
 488         as objects. The <a href="#ref_index">index</a> is a stored version of your working\r
 489         <a href="#ref_tree">tree</a>. Truth be told, it can also contain a second, and even\r
 490         a third version of a <a href="#ref_working_tree">working tree</a>, which are used\r
 491         when merging.\r
 492 </p>\r
 493 </dd>\r
 494 <dt>\r
 495 <a id="ref_index_entry"></a>index entry\r
 496 </dt>\r
 497 <dd>\r
 498 <p>\r
 499         The information regarding a particular file, stored in the\r
 500         <a href="#ref_index">index</a>. An <a href="#ref_index_entry">index entry</a> can be unmerged,\r
 501         if a <a href="#ref_merge">merge</a> was started, but not yet finished (i.e. if the\r
 502         <a href="#ref_index">index</a> contains multiple versions of that file).\r
 503 </p>\r
 504 </dd>\r
 505 <dt>\r
 506 <a id="ref_master"></a>master\r
 507 </dt>\r
 508 <dd>\r
 509 <p>\r
 510         The default <a href="#ref_branch">branch</a>. Whenever you create a git\r
 511         <a href="#ref_repository">repository</a>, a <a href="#ref_branch">branch</a> named\r
 512         "<a href="#ref_master">master</a>" is created, and becomes the active\r
 513         <a href="#ref_branch">branch</a>. In most cases, this contains the local\r
 514         development.\r
 515 </p>\r
 516 </dd>\r
 517 <dt>\r
 518 <a id="ref_merge"></a>merge\r
 519 </dt>\r
 520 <dd>\r
 521 <p>\r
 522         To <a href="#ref_merge">merge</a> branches means to try to accumulate the changes\r
 523         since a common ancestor and apply them to the first\r
 524         <a href="#ref_branch">branch</a>. An automatic <a href="#ref_merge">merge</a> uses heuristics\r
 525         to accomplish that. Evidently, an automatic <a href="#ref_merge">merge</a> can\r
 526         fail.\r
 527 </p>\r
 528 </dd>\r
 529 <dt>\r
 530 <a id="ref_object"></a>object\r
 531 </dt>\r
 532 <dd>\r
 533 <p>\r
 534         The unit of storage in git. It is uniquely identified by the\r
 535         <a href="#ref_SHA1">SHA1</a> of its contents. Consequently, an\r
 536         <a href="#ref_object">object</a> can not be changed.\r
 537 </p>\r
 538 </dd>\r
 539 <dt>\r
 540 <a id="ref_object_database"></a>object database\r
 541 </dt>\r
 542 <dd>\r
 543 <p>\r
 544         Stores a set of "objects", and an individual <a href="#ref_object">object</a> is\r
 545         identified by its <a href="#ref_object_name">object name</a>. The objects usually\r
 546         live in <tt>$GIT_DIR/objects/</tt>.\r
 547 </p>\r
 548 </dd>\r
 549 <dt>\r
 550 <a id="ref_object_identifier"></a>object identifier\r
 551 </dt>\r
 552 <dd>\r
 553 <p>\r
 554         Synonym for <a href="#ref_object_name">object name</a>.\r
 555 </p>\r
 556 </dd>\r
 557 <dt>\r
 558 <a id="ref_object_name"></a>object name\r
 559 </dt>\r
 560 <dd>\r
 561 <p>\r
 562         The unique identifier of an <a href="#ref_object">object</a>. The <a href="#ref_hash">hash</a>\r
 563         of the <a href="#ref_object">object</a>'s contents using the Secure Hash Algorithm\r
 564         1 and usually represented by the 40 character hexadecimal encoding of\r
 565         the <a href="#ref_hash">hash</a> of the <a href="#ref_object">object</a> (possibly followed by\r
 566         a white space).\r
 567 </p>\r
 568 </dd>\r
 569 <dt>\r
 570 <a id="ref_octopus"></a>octopus\r
 571 </dt>\r
 572 <dd>\r
 573 <p>\r
 574         To <a href="#ref_merge">merge</a> more than two branches. Also denotes an\r
 575         intelligent predator.\r
 576 </p>\r
 577 </dd>\r
 578 <dt>\r
 579 <a id="ref_origin"></a>origin\r
 580 </dt>\r
 581 <dd>\r
 582 <p>\r
 583         The default upstream <a href="#ref_branch">branch</a>. Most projects have one\r
 584         upstream project which they track, and by default\r
 585         <em><a href="#ref_origin">origin</a></em> is used for that purpose. New updates from\r
 586         upstream will be fetched into this <a href="#ref_branch">branch</a>; you should\r
 587         never <a href="#ref_commit">commit</a> to it yourself.\r
 588 </p>\r
 589 </dd>\r
 590 <dt>\r
 591 <a id="ref_pack"></a>pack\r
 592 </dt>\r
 593 <dd>\r
 594 <p>\r
 595         A set of objects which have been compressed into one file (to save space\r
 596         or to transmit them efficiently).\r
 597 </p>\r
 598 </dd>\r
 599 <dt>\r
 600 <a id="ref_pack_index"></a>pack index\r
 601 </dt>\r
 602 <dd>\r
 603 <p>\r
 604         The list of identifiers, and other information, of the objects in a\r
 605         <a href="#ref_pack">pack</a>, to assist in efficiently accessing the contents of a\r
 606         <a href="#ref_pack">pack</a>.\r
 607 </p>\r
 608 </dd>\r
 609 <dt>\r
 610 <a id="ref_parent"></a>parent\r
 611 </dt>\r
 612 <dd>\r
 613 <p>\r
 614         A <a href="#ref_commit_object">commit object</a> contains a (possibly empty) list\r
 615         of the logical predecessor(s) in the line of development, i.e. its\r
 616         parents.\r
 617 </p>\r
 618 </dd>\r
 619 <dt>\r
 620 <a id="ref_plumbing"></a>plumbing\r
 621 </dt>\r
 622 <dd>\r
 623 <p>\r
 624         Cute name for <a href="#ref_core_git">core git</a>.\r
 625 </p>\r
 626 </dd>\r
 627 <dt>\r
 628 <a id="ref_porcelain"></a>porcelain\r
 629 </dt>\r
 630 <dd>\r
 631 <p>\r
 632         Cute name for programs and program suites depending on\r
 633         <a href="#ref_core_git">core git</a>, presenting a high level access to\r
 634         <a href="#ref_core_git">core git</a>. Porcelains expose more of a <a href="#ref_SCM">SCM</a>\r
 635         interface than the <a href="#ref_plumbing">plumbing</a>.\r
 636 </p>\r
 637 </dd>\r
 638 <dt>\r
 639 <a id="ref_pull"></a>pull\r
 640 </dt>\r
 641 <dd>\r
 642 <p>\r
 643         Pulling a <a href="#ref_branch">branch</a> means to <a href="#ref_fetch">fetch</a> it and\r
 644         <a href="#ref_merge">merge</a> it.\r
 645 </p>\r
 646 </dd>\r
 647 <dt>\r
 648 <a id="ref_push"></a>push\r
 649 </dt>\r
 650 <dd>\r
 651 <p>\r
 652         Pushing a <a href="#ref_branch">branch</a> means to get the <a href="#ref_branch">branch</a>'s\r
 653         <a href="#ref_head_ref">head ref</a> from a remote <a href="#ref_repository">repository</a>,\r
 654         find out if it is an ancestor to the <a href="#ref_branch">branch</a>'s local\r
 655         <a href="#ref_head_ref">head ref</a> is a direct, and in that case, putting all\r
 656         objects, which are <a href="#ref_reachable">reachable</a> from the local\r
 657         <a href="#ref_head_ref">head ref</a>, and which are missing from the remote\r
 658         <a href="#ref_repository">repository</a>, into the remote\r
 659         <a href="#ref_object_database">object database</a>, and updating the remote\r
 660         <a href="#ref_head_ref">head ref</a>. If the remote <a href="#ref_head">head</a> is not an\r
 661         ancestor to the local <a href="#ref_head">head</a>, the <a href="#ref_push">push</a> fails.\r
 662 </p>\r
 663 </dd>\r
 664 <dt>\r
 665 <a id="ref_reachable"></a>reachable\r
 666 </dt>\r
 667 <dd>\r
 668 <p>\r
 669         An <a href="#ref_object">object</a> is <a href="#ref_reachable">reachable</a> from a\r
 670         <a href="#ref_ref">ref</a>/<a href="#ref_commit">commit</a>/<a href="#ref_tree">tree</a>/<a href="#ref_tag">tag</a>,\r
 671         if there is a <a href="#ref_chain">chain</a> leading from the latter to the former.\r
 672 </p>\r
 673 </dd>\r
 674 <dt>\r
 675 <a id="ref_rebase"></a>rebase\r
 676 </dt>\r
 677 <dd>\r
 678 <p>\r
 679         To <a href="#ref_clean">clean</a> a <a href="#ref_branch">branch</a> by starting from the\r
 680         <a href="#ref_head">head</a> of the main line of development\r
 681         ("<a href="#ref_master">master</a>"), and reapply the (possibly cherry-picked)\r
 682         changes from that <a href="#ref_branch">branch</a>.\r
 683 </p>\r
 684 </dd>\r
 685 <dt>\r
 686 <a id="ref_ref"></a>ref\r
 687 </dt>\r
 688 <dd>\r
 689 <p>\r
 690         A 40-byte hex representation of a <a href="#ref_SHA1">SHA1</a> pointing to a\r
 691         particular <a href="#ref_object">object</a>. These may be stored in\r
 692         <tt>$GIT_DIR/refs/</tt>.\r
 693 </p>\r
 694 </dd>\r
 695 <dt>\r
 696 <a id="ref_repository"></a>repository\r
 697 </dt>\r
 698 <dd>\r
 699 <p>\r
 700         A collection of refs together with an <a href="#ref_object_database">object         database</a> containing all objects, which are <a href="#ref_reachable">reachable</a>\r
 701         from the refs, possibly accompanied by meta data from one or more\r
 702         porcelains. A <a href="#ref_repository">repository</a> can share an\r
 703         <a href="#ref_object_database">object database</a> with other repositories.\r
 704 </p>\r
 705 </dd>\r
 706 <dt>\r
 707 <a id="ref_resolve"></a>resolve\r
 708 </dt>\r
 709 <dd>\r
 710 <p>\r
 711         The action of fixing up manually what a failed automatic\r
 712         <a href="#ref_merge">merge</a> left behind.\r
 713 </p>\r
 714 </dd>\r
 715 <dt>\r
 716 <a id="ref_revision"></a>revision\r
 717 </dt>\r
 718 <dd>\r
 719 <p>\r
 720         A particular state of files and directories which was stored in the\r
 721         <a href="#ref_object_database">object database</a>. It is referenced by a\r
 722         <a href="#ref_commit_object">commit object</a>.\r
 723 </p>\r
 724 </dd>\r
 725 <dt>\r
 726 <a id="ref_rewind"></a>rewind\r
 727 </dt>\r
 728 <dd>\r
 729 <p>\r
 730         To throw away part of the development, i.e. to assign the\r
 731         <a href="#ref_head">head</a> to an earlier <a href="#ref_revision">revision</a>.\r
 732 </p>\r
 733 </dd>\r
 734 <dt>\r
 735 <a id="ref_SCM"></a>SCM\r
 736 </dt>\r
 737 <dd>\r
 738 <p>\r
 739         Source code management (tool).\r
 740 </p>\r
 741 </dd>\r
 742 <dt>\r
 743 <a id="ref_SHA1"></a>SHA1\r
 744 </dt>\r
 745 <dd>\r
 746 <p>\r
 747         Synonym for <a href="#ref_object_name">object name</a>.\r
 748 </p>\r
 749 </dd>\r
 750 <dt>\r
 751 <a id="ref_tag"></a>tag\r
 752 </dt>\r
 753 <dd>\r
 754 <p>\r
 755         A <a href="#ref_ref">ref</a> pointing to a <a href="#ref_tag">tag</a> or\r
 756         <a href="#ref_commit_object">commit object</a>. In contrast to a <a href="#ref_head">head</a>,\r
 757         a <a href="#ref_tag">tag</a> is not changed by a <a href="#ref_commit">commit</a>. Tags (not\r
 758         <a href="#ref_tag">tag</a> objects) are stored in <tt>$GIT_DIR/refs/tags/</tt>. A git\r
 759         <a href="#ref_tag">tag</a> has nothing to do with a Lisp <a href="#ref_tag">tag</a> (which is\r
 760         called <a href="#ref_object">object</a> type in git's context). A <a href="#ref_tag">tag</a>\r
 761         is most typically used to mark a particular point in the\r
 762         <a href="#ref_commit">commit</a> ancestry <a href="#ref_chain">chain</a>.\r
 763 </p>\r
 764 </dd>\r
 765 <dt>\r
 766 <a id="ref_tag_object"></a>tag object\r
 767 </dt>\r
 768 <dd>\r
 769 <p>\r
 770         An <a href="#ref_object">object</a> containing a <a href="#ref_ref">ref</a> pointing to\r
 771         another <a href="#ref_object">object</a>, which can contain a message just like a\r
 772         <a href="#ref_commit_object">commit object</a>. It can also contain a (PGP)\r
 773         signature, in which case it is called a "signed <a href="#ref_tag_object">tag         object</a>".\r
 774 </p>\r
 775 </dd>\r
 776 <dt>\r
 777 <a id="ref_tree"></a>tree\r
 778 </dt>\r
 779 <dd>\r
 780 <p>\r
 781         Either a <a href="#ref_working_tree">working tree</a>, or a <a href="#ref_tree_object">tree         object</a> together with the dependent blob and <a href="#ref_tree">tree</a> objects\r
 782         (i.e. a stored representation of a <a href="#ref_working_tree">working tree</a>).\r
 783 </p>\r
 784 </dd>\r
 785 <dt>\r
 786 <a id="ref_tree_object"></a>tree object\r
 787 </dt>\r
 788 <dd>\r
 789 <p>\r
 790         An <a href="#ref_object">object</a> containing a list of file names and modes along\r
 791         with refs to the associated blob and/or <a href="#ref_tree">tree</a> objects. A\r
 792         <a href="#ref_tree">tree</a> is equivalent to a <a href="#ref_directory">directory</a>.\r
 793 </p>\r
 794 </dd>\r
 795 <dt>\r
 796 <a id="ref_tree-ish"></a>tree-ish\r
 797 </dt>\r
 798 <dd>\r
 799 <p>\r
 800         A <a href="#ref_ref">ref</a> pointing to either a <a href="#ref_commit_object">commit         object</a>, a <a href="#ref_tree_object">tree object</a>, or a <a href="#ref_tag_object">tag         object</a> pointing to a <a href="#ref_tag">tag</a> or <a href="#ref_commit">commit</a> or\r
 801         <a href="#ref_tree_object">tree object</a>.\r
 802 </p>\r
 803 </dd>\r
 804 <dt>\r
 805 <a id="ref_working_tree"></a>working tree\r
 806 </dt>\r
 807 <dd>\r
 808 <p>\r
 809         The set of files and directories currently being worked on, i.e. you can\r
 810         work in your <a href="#ref_working_tree">working tree</a> without using git at all.\r
 811 </p>\r
 812 </dd>\r
 813 </dl>\r
 814 </div>\r
 815 </div>\r
 816 <h2>Author</h2>\r
 817 <div class="sectionbody">\r
 818 <p>Written by Johannes Schindelin &lt;Johannes.Schindelin@gmx.de&gt; and\r
 819 the git-list &lt;git@vger.kernel.org&gt;.</p>\r
 820 </div>\r
 821 <h2>GIT</h2>\r
 822 <div class="sectionbody">\r
 823 <p>Part of the <a href="git.html">git</a> suite</p>\r
 824 </div>\r
 825 <div id="footer">\r
 826 <div id="footer-text">\r
 827 Last updated 10-Jan-2006 16:53:50 PDT\r
 828 </div>\r
 829 </div>\r
 830 </body>\r
 831 </html>\r