github.com/kaydxh/golang@v0.0.131/pkg/gocv/cgo/third_path/graphics-magick/share/doc/GraphicsMagick/www/Hg.html (about)

     1  <?xml version="1.0" encoding="utf-8" ?>
     2  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
     3  <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
     4  <head>
     5  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
     6  <meta name="generator" content="Docutils 0.15.2: http://docutils.sourceforge.net/" />
     7  <title>GraphicsMagick Mercurial</title>
     8  <meta content="GraphicsMagick is a robust collection of tools and libraries to read, write, and manipulate an image in any of the more popular image formats including GIF, JPEG, PNG, PDF, and Photo CD. With GraphicsMagick you can create GIFs dynamically making it suitable for Web applications.  You can also resize, rotate, sharpen, color reduce, or add special effects to an image and save your completed work in the same or differing image format. " name="description" />
     9  <meta content="GraphicsMagick, PerlMagick, visualization, image processing, software development, simulation, image, software, Magick++" name="keywords" />
    10  <link rel="stylesheet" href="docutils-articles.css" type="text/css" />
    11  </head>
    12  <body>
    13  
    14  <div class="banner">
    15  <img src="images/gm-107x76.png" alt="GraphicMagick logo" width="107" height="76" />
    16  <span class="title">GraphicsMagick</span>
    17  <form action="http://www.google.com/search">
    18  	<input type="hidden" name="domains" value="www.graphicsmagick.org" />
    19  	<input type="hidden" name="sitesearch" value="www.graphicsmagick.org" />
    20      <span class="nowrap"><input type="text" name="q" size="25" maxlength="255" />&nbsp;<input type="submit" name="sa" value="Search" /></span>
    21  </form>
    22  </div>
    23  
    24  <div class="navmenu">
    25  <ul>
    26  <li><a href="index.html">Home</a></li>
    27  <li><a href="project.html">Project</a></li>
    28  <li><a href="download.html">Download</a></li>
    29  <li><a href="README.html">Install</a></li>
    30  <li><a href="Hg.html">Source</a></li>
    31  <li><a href="NEWS.html">News</a> </li>
    32  <li><a href="utilities.html">Utilities</a></li>
    33  <li><a href="programming.html">Programming</a></li>
    34  <li><a href="reference.html">Reference</a></li>
    35  </ul>
    36  </div>
    37  <div class="document" id="graphicsmagick-mercurial">
    38  <h1 class="title">GraphicsMagick Mercurial</h1>
    39  
    40  <!-- -*- mode: rst -*- -->
    41  <!-- This text is in reStucturedText format, so it may look a bit odd. -->
    42  <!-- See http://docutils.sourceforge.net/rst.html for details. -->
    43  <div class="contents topic" id="contents">
    44  <p class="topic-title first">Contents</p>
    45  <ul class="simple">
    46  <li><a class="reference internal" href="#what-is-mercurial" id="id1">What is Mercurial?</a></li>
    47  <li><a class="reference internal" href="#web-access" id="id2">Web Access</a></li>
    48  <li><a class="reference internal" href="#cloning-the-mercurial-repository" id="id3">Cloning the Mercurial Repository</a></li>
    49  <li><a class="reference internal" href="#selecting-a-version-of-the-code" id="id4">Selecting a version of the code</a></li>
    50  <li><a class="reference internal" href="#updating-from-the-mercurial-repository" id="id5">Updating from the Mercurial Repository</a></li>
    51  <li><a class="reference internal" href="#mercurial-software" id="id6">Mercurial Software</a></li>
    52  <li><a class="reference internal" href="#mercurial-for-graphicsmagick-developers" id="id7">Mercurial for GraphicsMagick Developers</a></li>
    53  <li><a class="reference internal" href="#ssh-public-keys-for-hg-graphicsmagick-org" id="id8">SSH Public Keys For hg.GraphicsMagick.org</a></li>
    54  <li><a class="reference internal" href="#email-notifications" id="id9">Email Notifications</a></li>
    55  <li><a class="reference internal" href="#mercurial-topics" id="id10">Mercurial Topics</a></li>
    56  </ul>
    57  </div>
    58  <p>The GraphicsMagick source code is available via <a class="reference external" href="https://www.mercurial-scm.org/">Mercurial</a>. <a class="reference external" href="https://www.mercurial-scm.org/">Mercurial</a>
    59  is a convenient way for developers from around the country or world to
    60  download the GraphicsMagick source, fix bugs, or add new features.
    61  Due to the way <a class="reference external" href="https://www.mercurial-scm.org/">Mercurial</a> works, it may also be used to manage local
    62  changes to GraphicsMagick.</p>
    63  <div class="section" id="what-is-mercurial">
    64  <h1><a class="toc-backref" href="#id1">What is Mercurial?</a></h1>
    65  <p><a class="reference external" href="https://www.mercurial-scm.org/">Mercurial</a> (also known as <cite>Hg</cite> due to the abbreviation for Mercury in
    66  the periodic table of the elements) is a modern source control system
    67  which provides anyone who clones a repository with a stand-alone local
    68  repository containing the full development history and the ability to
    69  select any version of the code.  Since the local repository is
    70  fully-functional, you may use the same repository to manage your local
    71  changes to GraphicsMagick code and you may use the repository to share
    72  your changes with others.</p>
    73  </div>
    74  <div class="section" id="web-access">
    75  <h1><a class="toc-backref" href="#id2">Web Access</a></h1>
    76  <p>The <a class="reference external" href="http://hg.code.sf.net/p/graphicsmagick/code/">GraphicsMagick repository at SourceForge</a> web interface is
    77  available which may be used to interactively view the latest versions
    78  of files, or the changes to files, using your web browser.</p>
    79  </div>
    80  <div class="section" id="cloning-the-mercurial-repository">
    81  <h1><a class="toc-backref" href="#id3">Cloning the Mercurial Repository</a></h1>
    82  <p>To get the tree and place it in a sub-directory of your current working
    83  directory, issue the command:</p>
    84  <pre class="literal-block">
    85  hg clone http://hg.code.sf.net/p/graphicsmagick/code GM
    86  </pre>
    87  </div>
    88  <div class="section" id="selecting-a-version-of-the-code">
    89  <h1><a class="toc-backref" href="#id4">Selecting a version of the code</a></h1>
    90  <p>By default the cloned directory is populated with files from the
    91  <cite>default</cite> (i.e. head) branch of the code, which is where active
    92  development happens.</p>
    93  <p>If you require a specific release of GraphicsMagick (e.g. 1.3.23), you may select it like:</p>
    94  <pre class="literal-block">
    95  hg update -r GraphicsMagick-1_3_23
    96  </pre>
    97  <p>or if you require a specific branch of GraphicsMagick (e.g. 1.3), you may use:</p>
    98  <pre class="literal-block">
    99  hg update -r GraphicsMagick-1_3
   100  </pre>
   101  <p>or you may request the files which were current on a specific date:</p>
   102  <pre class="literal-block">
   103  hg update -d 2009-01-14
   104  </pre>
   105  <p>Use:</p>
   106  <pre class="literal-block">
   107  hg branches
   108  </pre>
   109  <p>to see the available branches, and:</p>
   110  <pre class="literal-block">
   111  hg tags
   112  </pre>
   113  <p>to see the available release tags.</p>
   114  </div>
   115  <div class="section" id="updating-from-the-mercurial-repository">
   116  <h1><a class="toc-backref" href="#id5">Updating from the Mercurial Repository</a></h1>
   117  <p>To pull more changes from the repository, execute:</p>
   118  <pre class="literal-block">
   119  hg pull
   120  </pre>
   121  <p>and to make them visible in your files (via a merge), execute:</p>
   122  <pre class="literal-block">
   123  hg update
   124  </pre>
   125  <p>or just:</p>
   126  <pre class="literal-block">
   127  hg pull -u
   128  </pre>
   129  <p>The latter pulls down any updates into your local repository and
   130  automatically does a merge.</p>
   131  </div>
   132  <div class="section" id="mercurial-software">
   133  <h1><a class="toc-backref" href="#id6">Mercurial Software</a></h1>
   134  <p>The best place to look for the latest version of Mercurial (<cite>Hg</cite>) is
   135  at the <a class="reference external" href="https://www.mercurial-scm.org/">Mercurial</a> web site.  Most free operating systems (e.g. Linux,
   136  OpenIndiana, and *BSD) will offer a version of Mercurial as an
   137  installable package and it may already be installed on your system.
   138  We recommend use of <a class="reference external" href="https://tortoisehg.bitbucket.io/">TortoiseHg</a> on Microsoft Windows systems since it
   139  provides a very nice graphical interface.  <a class="reference external" href="https://tortoisehg.bitbucket.io/">TortoiseHg</a> is also
   140  available on Linux and other systems.</p>
   141  </div>
   142  <div class="section" id="mercurial-for-graphicsmagick-developers">
   143  <h1><a class="toc-backref" href="#id7">Mercurial for GraphicsMagick Developers</a></h1>
   144  <p>Since <a class="reference external" href="https://www.mercurial-scm.org/">Mercurial</a> is a distributed revision control system, you may
   145  clone the GraphicsMagick repository and work for days or weeks (making
   146  your own local commits) before you decide to push some or all of your
   147  changes to the GraphicsMagick development repository.  GraphicsMagick
   148  developers first commit changes to their own local respository, then
   149  they push their changes to the GraphicsMagick development repository
   150  at hg.graphicsmagick.org, later on (after testing and possible fixes)
   151  I will push the changes to the stable repository at SourceForge.
   152  Pushes to the stable repository at SourceForge should occur at least
   153  as often as source code snapshots are produced.</p>
   154  <p>The repository hierarchy is as follows:</p>
   155  <ol class="arabic simple">
   156  <li>Local</li>
   157  </ol>
   158  <blockquote>
   159  The developer makes any local changes and commits what he likes in his
   160  own repository.  It is best to commit often and whenever all the
   161  files have been updated to implement a coherent change or feature
   162  (including the ChangeLog file!) since <a class="reference external" href="https://www.mercurial-scm.org/">Mercurial</a> stores related
   163  changes as a changeset along with the change message you enter.
   164  When you push your repository, these changesets and messages are
   165  preserved.</blockquote>
   166  <ol class="arabic simple" start="2">
   167  <li>Unstable</li>
   168  </ol>
   169  <blockquote>
   170  <p>The unstable development repository is available via ssh at
   171  &quot;<a class="reference external" href="ssh://yourid&#64;hg.GraphicsMagick.org//hg/GraphicsMagick">ssh://yourid&#64;hg.GraphicsMagick.org//hg/GraphicsMagick</a>&quot;.</p>
   172  <p>Where <cite>yourid</cite> is the Unix user ID on the GraphicsMagick server.
   173  The <cite>yourid&#64;</cite> part may left out if your client system uses the same
   174  user ID as on the GraphicsMagick server.</p>
   175  </blockquote>
   176  <ol class="arabic simple" start="3">
   177  <li>Stable</li>
   178  </ol>
   179  <blockquote>
   180  The stable repository is available via http at
   181  &quot;<a class="reference external" href="http://hg.code.sf.net/p/graphicsmagick/code">http://hg.code.sf.net/p/graphicsmagick/code</a>&quot;.  Any changes in the
   182  unstable development repository are pushed to the stable repository
   183  (by the developer responsible for this role) once any necessary
   184  adjustments have been made, documentation files have been generated,
   185  and the software test suite has passed on at least one machine.</blockquote>
   186  <p>To build your local development repository (as quickly as possible),
   187  you may use these steps:</p>
   188  <ol class="arabic">
   189  <li><p class="first">Clone the stable respository at SourceForge:</p>
   190  <pre class="literal-block">
   191  hg clone http://hg.code.sf.net/p/graphicsmagick/code GM
   192  </pre>
   193  </li>
   194  <li><p class="first">Adjust your local repository path default to use the unstable repository.</p>
   195  <p>Edit .hg/hgrc in your local repository so that it contains:</p>
   196  <pre class="literal-block">
   197  [paths]
   198  default = ssh://yourid&#64;hg.GraphicsMagick.org//hg/GraphicsMagick
   199  </pre>
   200  <p>where <cite>yourid</cite> is the Unix user ID on the GraphicsMagick server.</p>
   201  </li>
   202  <li><p class="first">Pull any additional pending updates from the unstable repository:</p>
   203  <pre class="literal-block">
   204  hg pull -u
   205  </pre>
   206  </li>
   207  </ol>
   208  <p>Please note that when ssh access is used, Mercurial uncompresses any
   209  data and sends it in uncompressed form.  Mercurial expects that
   210  compression will be enabled in ssh when needed.  One way to enable ssh
   211  compression is to put this in your local .hgrc:</p>
   212  <pre class="literal-block">
   213  [ui]
   214  ssh = ssh -C
   215  </pre>
   216  <p>but ssh also provides its own way to enable compression on a
   217  site-by-site basis (e.g. via .ssh/config).  For example an entry in
   218  .ssh/config will enable use of compression:</p>
   219  <pre class="literal-block">
   220  Host hg.GraphicsMagick.org
   221    Compression yes
   222  </pre>
   223  </div>
   224  <div class="section" id="ssh-public-keys-for-hg-graphicsmagick-org">
   225  <h1><a class="toc-backref" href="#id8">SSH Public Keys For hg.GraphicsMagick.org</a></h1>
   226  <p>For reference, these are the ssh public keys for the server at hg.GraphicsMagick.org:</p>
   227  <p>DSS (DSA):</p>
   228  <pre class="literal-block">
   229  ssh-dss AAAAB3NzaC1kc3MAAACBANZAsDZ9fUWQNwUoRw8HoNl8aLLs97KmyiaA6mSPeM1NeQKrxk0PAFEXMR05CNcZHSyopUx6B8PuTWE4+4rDhFCw7J0JkfFS4uIG3bu3YCRqQrg2k4VsDw60zK9sNum5BcLEWd+qs8X7DrEff5fGmXkc8IdMXPgHTzaJWCT9YJU1AAAAFQCJaFq4/7FqHcHm5abhW5qJyH0RgQAAAIEAgv6s3gfB8p/Elf0ZcIZ5eITCpI9aZFaSLSeKHMmhYps1uMuZ9LtWjZ11cotcuOh0tlwGUixlu/5soZqX6VbnJAuyvfI+7WSUFuJmRjsbXJVCBuSPZ7YgMNuLYlLst7sZLCs5hU61jxnaR2zmkUjDWP4GWROC6AYZXlbJX1qRJ7YAAACBAMsIbVVgz/aP95yCPk1Pw0FjoL5t6C3BpxdA9aiIFBMg14ElaHh+gaXQoZfjAuafZ8pc5woYtQLLkzinCQnmvH/EqqYCe+Fu7jcsYU7oWUXG1O9ZBKI7QZkeCTaYMXIWBplgVD+tkRpH/gxn5iweNMM9e43qPB0b2JYObliqD1E9 root&#64;src
   230  </pre>
   231  <p>RSA:</p>
   232  <pre class="literal-block">
   233  ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEA1IuJDYT85qz/w6+vn5hkpzM5Ju5dsMeJD9GnATj3op5dhBWyfbaJpS7yyK2Vhhz26GBUvUtO3LGm0dQvdj83P3DX3aUuzfnC3Bc9dWeARomQPtDy9MfDikD6kqjD9/Lemgvv8I4Na9vUEmYvXUpTrtawJ4S7A7IctPnvKLPGA5+qY5XzMSE0wcOSBdbeV1PAIDOXYH2hKakZwtxXlvfTv6CZphz/jG5nmf+/Zlkr4yopNvPFbtd3vbaaqSuCoGHXKfmpRko2gXf6EGF92wXzbsE1tW3AkSJ2xdhFHRNmQEu2y9F1l9zb8IETBtKMWRJWAsPPpUSkht0DRsTXt/f+Zw== root&#64;src
   234  </pre>
   235  <p>ECDSA:</p>
   236  <pre class="literal-block">
   237  ecdsa-sha2-nistp256 AAAAE2VjZHNhLXNoYTItbmlzdHAyNTYAAAAIbmlzdHAyNTYAAABBBOrGQ6tjmZvm8w+GP7yLFJ1/vkImKkpXv7kPNxA0+Sfx6WCqAjV0pWP5MVCraP8SNbphL8jiS/x3WADXlf+R2KQ= root&#64;src
   238  </pre>
   239  <p>ED25519:</p>
   240  <pre class="literal-block">
   241  ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIAtwIcJEBiSUWsB2sydInR76gE84Jp1rxmc8lTGPg5cB root&#64;src
   242  </pre>
   243  </div>
   244  <div class="section" id="email-notifications">
   245  <h1><a class="toc-backref" href="#id9">Email Notifications</a></h1>
   246  <p>An email notification is sent to the <a class="reference external" href="https://lists.sourceforge.net/lists/listinfo/graphicsmagick-commit">graphicsmagick-commit</a> mailing
   247  list at SourceForge whenever a change is submitted to the development
   248  (unstable) repository.  Subscribe to this list if you would like to be
   249  notified by email of changes when they occur.</p>
   250  </div>
   251  <div class="section" id="mercurial-topics">
   252  <h1><a class="toc-backref" href="#id10">Mercurial Topics</a></h1>
   253  <ul class="simple">
   254  <li><a class="reference external" href="https://www.mercurial-scm.org/wiki/MergeToolConfiguration">Merge Tool Configuration</a></li>
   255  <li><a class="reference external" href="https://www.mercurial-scm.org/wiki/TipsAndTricks#Keep_.22My.22_or_.22Their.22_files_when_doing_a_merge">Keep &quot;My&quot; or &quot;Their&quot; files when doing a merge</a></li>
   256  </ul>
   257  <hr class="docutils" />
   258  <p>Copyright © GraphicsMagick Group 2012 - 2020</p>
   259  </div>
   260  </div>
   261  </body>
   262  </html>