doc/source/en/TortoiseGit/tsvn_preface.xml

   1 <?xml version="1.0" encoding="UTF-8"?>\r
   2 <!DOCTYPE preface SYSTEM "../../dtd/dblite.dtd">\r
   3 <preface id="tsvn-preface">\r
   4         <title>Preface</title>\r
   5         <simplesect>\r
   6                 <graphic srccredit="TortoiseGit Logo" fileref="images/TortoiseGit_logo_hor468x64.png" scalefit="1" />\r
   7         </simplesect>\r
   8         <simplesect>\r
   9                 <para>\r
  10                         <itemizedlist>\r
  11                                 <listitem>\r
  12                                         <para>\r
  13                                                 Do you work in a team?\r
  14                                         </para>\r
  15                                 </listitem>\r
  16                                 <listitem>\r
  17                                         <para>\r
  18                                                 Has it ever happened that you were working on a file,\r
  19                                                 and someone else was working on the same file at the same time?\r
  20                                                 Did you lose your changes to that file because of that?\r
  21                                         </para>\r
  22                                 </listitem>\r
  23                                 <listitem>\r
  24                                         <para>\r
  25                                                 Have you ever saved a file, and then wanted to\r
  26                                                 revert the changes you made? Have you ever wished you\r
  27                                                 could see what a file looked like some time ago?\r
  28                                         </para>\r
  29                                 </listitem>\r
  30                                 <listitem>\r
  31                                         <para>\r
  32                                                 Have you ever found a bug in your project and\r
  33                                                 wanted to know when that bug got into your files?\r
  34                                         </para>\r
  35                                 </listitem>\r
  36                         </itemizedlist>\r
  37                 </para>\r
  38                 <para>\r
  39                         If you answered <quote>yes</quote> to one of these questions, then\r
  40                         TortoiseGit is for you! Just read on to find out how TortoiseGit\r
  41                         can help you in your work. It's not that difficult.\r
  42                 </para>\r
  43         </simplesect>\r
  44         <!-- =================================================================== -->\r
  45         <!-- ========================   SECTION 1 ============================== -->\r
  46         <!-- =================================================================== -->\r
  47         <sect1 id="tsvn-preface-audience">\r
  48                 <title>Audience</title>\r
  49                 <para>\r
  50                         This book is written for computer literate folk who want to\r
  51                         use Git to manage their data, but are uncomfortable using the\r
  52                         command line client to do so. Since TortoiseGit is a windows shell\r
  53                         extension it's assumed that the user is familiar with the windows\r
  54                         explorer and knows how to use it.\r
  55                 </para>\r
  56         </sect1>\r
  57         <!-- =================================================================== -->\r
  58         <!-- ========================   SECTION 1a ============================= -->\r
  59         <!-- =================================================================== -->\r
  60         <sect1 id="tsvn-preface-readingguide">\r
  61                 <title>Reading Guide</title>\r
  62                 <para>\r
  63                         This <xref linkend="tsvn-preface"/> explains a little about the\r
  64                         TortoiseGit project, the community of people who work on it, and\r
  65                         the licensing conditions for using it and distributing it.\r
  66                 </para>\r
  67                 <para>\r
  68                         The <xref linkend="tsvn-introduction"/> explains what TortoiseGit is,\r
  69                         what it does, where it comes from and the basics for installing it\r
  70                         on your PC.\r
  71                 </para>\r
  72                 <para>\r
  73                         In <xref linkend="git-book"/> we give a short introduction\r
  74                         to the <emphasis>Git</emphasis> revision control system. \r
  75                         This is borrowed from the documentation for the\r
  76                         Git project and explains the different approaches to version\r
  77                         control, and how Git works.\r
  78                 </para>\r
  79     <!--\r
  80                 <para>\r
  81                         Even most Git users will never have to set up a server themselves.\r
  82                         The next chapter deals with how to set up such a server, and is useful\r
  83                         for administrators.\r
  84                 </para>\r
  85     -->\r
  86     <!--\r
  87                 <para>\r
  88                         The chapter on <xref linkend="tsvn-repository"/> explains how to set up\r
  89                         a local repository, which is useful for testing Git and TortoiseGit\r
  90                         using a single PC. It also explains a bit about repository administration\r
  91                         which is also relevant to repositories located on a server.\r
  92                 </para>\r
  93     -->\r
  94                 <para>\r
  95                         The <xref linkend="tsvn-dug"/> is the most important section as\r
  96                         it explains all the main features of TortoiseGit and how to use them.\r
  97                         It takes the form of a tutorial, starting with checking out a working copy,\r
  98                         modifying it, committing your changes, etc. It then progresses to more\r
  99                         advanced topics.\r
 100                 </para>\r
 101                 <!--\r
 102                 <para>\r
 103                         <xref linkend="tsvn-subwcrev"/> is a separate program included with TortoiseGit\r
 104                         which can extract the information from your working copy and write it into a\r
 105                         file. This is useful for including build information in your projects.\r
 106                 </para>\r
 107                 -->\r
 108                 <para>\r
 109                         The <xref linkend="tsvn-howto"/> section answers some common questions\r
 110                         about performing tasks which are not explicitly covered elsewhere.\r
 111                 </para>\r
 112                 <para>\r
 113                         The section on <xref linkend="tsvn-automation"/> shows how the\r
 114                         TortoiseGit GUI dialogs can be called from the command line. This is useful\r
 115                         for scripting where you still need user interaction.\r
 116                 </para>\r
 117                 <para>\r
 118                         The <xref linkend="git(1)"/> give git official document about\r
 119                         command line client <literal>git.exe</literal>.\r
 120                 </para>\r
 121         </sect1>\r
 122         <!-- =================================================================== -->\r
 123         <!-- ========================   SECTION 2 ============================== -->\r
 124         <!-- =================================================================== -->\r
 125         <sect1 id="tsvn-preface-source">\r
 126                 <title>TortoiseGit is free!</title>\r
 127                 <para>\r
 128                         TortoiseGit is free. You don't have to pay to use it, and you can use it\r
 129                         any way you want. It is developed under the GNU General Public License (GPL).\r
 130                 </para>\r
 131                 <para>\r
 132                         TortoiseGit is an Open Source project. That means you have full\r
 133                         read access to the source code of this program. Project Home is \r
 134                         <ulink url="http://code.google.com/p/tortoisegit">\r
 135                                 <citetitle>http://code.google.com/p/tortoisegit</citetitle>\r
 136                         </ulink>\r
 137                 </para>\r
 138         </sect1>\r
 139         <!-- =================================================================== -->\r
 140         <!-- ========================   SECTION 3 ============================== -->\r
 141         <!-- =================================================================== -->\r
 142         <sect1 id="tsvn-preface-community">\r
 143                 <title>Community</title>\r
 144                 <para>\r
 145                         Both TortoiseGit and Git are developed by a community of\r
 146                         people who are working on those projects. They come from different\r
 147                         countries all over the world and joined together to create wonderful\r
 148                         programs.\r
 149                 </para>\r
 150         </sect1>\r
 151         <!-- =================================================================== -->\r
 152         <!-- ========================   SECTION 4 ============================== -->\r
 153         <!-- =================================================================== -->\r
 154         <sect1 id="tsvn-preface-acknowledgements">\r
 155                 <title>Acknowledgments</title>\r
 156                 <variablelist>\r
 157                         <varlistentry>\r
 158                                 <term>Frank Li "lznuaa@gmail.com"</term>\r
 159                                 <listitem>\r
 160                                         <para>\r
 161                                                 for founding the TortoiseGit project\r
 162                                         </para>\r
 163                                 </listitem>\r
 164                         </varlistentry>\r
 165                         <varlistentry>\r
 166                                 <term>myagi(Georg Fischer) "snowcoder@gmail.com"</term>\r
 167                                 <listitem>\r
 168                                         <para>\r
 169                                         \r
 170                                         For hard work to get TortoiseGit Overlay work.\r
 171                                         </para>\r
 172                                 </listitem>\r
 173                         </varlistentry>\r
 174                         <varlistentry>\r
 175                                 <term>Colin Law</term>\r
 176                                 <listitem>\r
 177                                         <para>                                          \r
 178                                         </para>\r
 179                                 </listitem>\r
 180                         </varlistentry>                 \r
 181                         <varlistentry>\r
 182                                 <term>Johan t Hart</term>\r
 183                                 <listitem>\r
 184                                         <para>                                          \r
 185                                         </para>\r
 186                                 </listitem>\r
 187                         </varlistentry>\r
 188                         <varlistentry>\r
 189                                 <term>Tim Kemp</term>\r
 190                                 <listitem>\r
 191                                         <para>\r
 192                                                 for founding the TortoiseSVN project(TortoiseGit come from this project)\r
 193                                         </para>\r
 194                                 </listitem>\r
 195                         </varlistentry>\r
 196                         <varlistentry>\r
 197                                 <term>Stefan Küng</term>\r
 198                                 <listitem>\r
 199                                         <para>\r
 200                                                 for the hard work to get TortoiseGit to what it is now\r
 201                                         </para>\r
 202                                 </listitem>\r
 203                         </varlistentry>\r
 204                         <varlistentry>\r
 205                                 <term>Lübbe Onken</term>\r
 206                                 <listitem>\r
 207                                         <para>\r
 208                                                 for the beautiful icons, logo, bug hunting, translating and\r
 209                                                 managing the translations\r
 210                                         </para>\r
 211                                 </listitem>\r
 212                         </varlistentry>\r
 213                         <varlistentry>\r
 214                                 <term>Simon Large</term>\r
 215                                 <listitem>\r
 216                                         <para>\r
 217                                                 for helping with the documentation and bug hunting\r
 218                                         </para>\r
 219                                 </listitem>\r
 220                         </varlistentry>\r
 221                         <varlistentry>\r
 222                                 <term>The Git Book</term>\r
 223                                 <listitem>\r
 224                                         <para>\r
 225                                                 for the great introduction to Git and its\r
 226                                                 chapter 2 which we copied here\r
 227                                         </para>\r
 228                                 </listitem>\r
 229                         </varlistentry>\r
 230                         <varlistentry>\r
 231                                 <term>The Tigris Style project</term>\r
 232                                 <listitem>\r
 233                                         <para>\r
 234                                                 for some of the styles which are reused in this documentation\r
 235                                         </para>\r
 236                                 </listitem>\r
 237                         </varlistentry>\r
 238                         <varlistentry>\r
 239                                 <term>Our Contributors</term>\r
 240                                 <listitem>\r
 241                                         <para>\r
 242                                                 for the patches, bug reports and new ideas, and for\r
 243                                                 helping others by answering questions on our mailing list.\r
 244                                         </para>\r
 245                                 </listitem>\r
 246                         </varlistentry>\r
 247                         <varlistentry>\r
 248                                 <term>Our Donators</term>\r
 249                                 <listitem>\r
 250                                         <para>\r
 251                                                 for many hours of joy with the music they sent us\r
 252                                         </para>\r
 253                                 </listitem>\r
 254                         </varlistentry>\r
 255                 </variablelist>\r
 256         </sect1>\r
 257         <!-- ================================================================= -->\r
 258         <!-- ======================== SECTION 5 ============================== -->\r
 259         <!-- ================================================================= -->\r
 260         <sect1 id="tsvn-preface-terminoloty">\r
 261                 <title>Terminology used in this document</title>\r
 262                 <para>\r
 263                         To make reading the docs easier, the names of all the screens and Menus \r
 264                         from TortoiseGit are marked up in a different font.\r
 265                         The <guilabel>Log Dialog</guilabel> for instance.\r
 266                 </para>\r
 267                 <para>\r
 268                         A menu choice is indicated with an arrow.\r
 269                         <menuchoice>\r
 270                                 <guimenu>TortoiseGit</guimenu>\r
 271                                 <guimenuitem>Show Log</guimenuitem>\r
 272                         </menuchoice>\r
 273                         means: select <emphasis>Show Log</emphasis> from the\r
 274                         <emphasis>TortoiseGit</emphasis> context menu.\r
 275                 </para>\r
 276                 <para>\r
 277                         Where a local context menu appears within one of the TortoiseGit\r
 278                         dialogs, it is shown like this:\r
 279                         <menuchoice>\r
 280                                 <guimenu>Context Menu</guimenu>\r
 281                                 <guimenuitem>Save As ...</guimenuitem>\r
 282                         </menuchoice>\r
 283                 </para>\r
 284                 <para>\r
 285                         User Interface Buttons are indicated like this:\r
 286                         Press <guibutton>OK</guibutton> to continue.\r
 287                 </para>\r
 288                 <para>\r
 289                         User Actions are indicated using a bold font.\r
 290                         <keycap>Alt+A</keycap>: press the\r
 291                         <keycap>Alt</keycap>-Key on your keyboard and while holding it down\r
 292                         press the <keycap>A</keycap>-Key as well.\r
 293                         <action>Right-drag</action>: press the right mouse button and while\r
 294                         holding it down <emphasis>drag</emphasis> the items to the new location.\r
 295                 </para>\r
 296                 <para>\r
 297                         System output and keyboard input is indicated with a\r
 298                         <literal>different</literal> font as well.\r
 299                 </para>\r
 300                 <important>\r
 301                         <para>\r
 302                                 Important notes are marked with an icon.\r
 303                         </para>\r
 304                 </important>\r
 305                 <tip>\r
 306                         <para>\r
 307                                 Tips that make your life easier.\r
 308                         </para>\r
 309                 </tip>\r
 310                 <caution>\r
 311                         <para>\r
 312                                 Places where you have to be careful what you are doing.\r
 313                         </para>\r
 314                 </caution>\r
 315                 <warning>\r
 316                         <para>\r
 317                                 Where extreme care has to be taken, data corruption or other\r
 318                                 nasty things may occur if these warnings are ignored.\r
 319                         </para>\r
 320                 </warning>\r
 321                 <graphic srccredit="hide" fileref="images/background.png" scalefit="1" width="100%"/>\r
 322         </sect1>\r
 323 </preface>\r