Helix SwarmHelix Swarm
Loading...

config.labeling_subversion_paths.html

  • //
  • guest/
  • paul_allen/
  • p4convert-maven/
  • docs/
  • p4convert/
  • publicsite-generated/
  • config.labeling_subversion_paths.html #1
  • View
  • Commits
  • Open Download .zip Download (9 KB) 
  1. <!DOCTYPE html><html>
  2.    <head>
  3.       <meta http-equiv="X-UA-Compatible" content="IE=edge" />
  4.       <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
  5.       <title>Labeling Subversion Paths // P4Convert: User Guide</title>
  6.       <meta name="generator" content="DocBook XSL Stylesheets V1.78.1 with Perforce customizations" />
  7.       <link rel="home" href="copyright.html" title="P4Convert: User Guide" />
  8.       <link rel="up" href="chapter.config.html" title="Configuration" />
  9.       <link rel="prev" href="config.filtering_subversion_paths.html" title="Filtering Subversion paths" />
  10.       <link rel="next" href="config.changelist_offset_options.html" title="Changelist Offset options" />
  11.       <meta name="Section-title" content="Labeling Subversion Paths" />
  12.       <meta name="viewport" content="width=device-width, initial-scale=1.0" />
  13.       <link rel="stylesheet" href="vendor/bootstrap/css/bootstrap.css" />
  14.       <link rel="stylesheet" href="vendor/prettify/prettify.css" />
  15.       <link rel="stylesheet" href="css/perforce.css" />
  16.       <link rel="stylesheet" href="css/print.css" media="print" />
  17.       <link rel="shortcut icon" href="images/favicon.ico" />
  18.       <!--[if lt IE 9]>
  19.   <script type="text/javascript" src="vendor/respond/respond.min.js"></script>
  20.   <link rel="stylesheet" type="text/css" href="css/ie.css"/>
  21. <![endif]-->
  22.    </head>
  23.    <body><a id="page-top"></a><div id="header">
  24.          <div class="container"><button name="toc" type="button" class="toc"><span class="glyphicon glyphicon-list"></span></button><span class="logo"><a href="http://www.perforce.com/documentation"></a></span><h1><a href="index.html" class="title"><span class="brand"></span><span class="guide-title">P4Convert: User Guide</span><span class="guide-subtitle">
  25.                                    (April 2015)
  26.                                  </span></a></h1><a title="Download a PDF version of this guide" class="pdf" href="ethel.pdf"><span class="glyphicon glyphicon-book"></span></a><button name="search" type="button" class="search" title="Search this guide"><span class="glyphicon glyphicon-search"></span></button></div>
  27.          <div id="progress"></div>
  28.       </div>
  29.       <div id="content" class="content" tabindex="-1">
  30.          <div class="container">
  31.             <!---->
  32.             <div class="section" id="config.labeling_subversion_paths">
  33.                <div class="titlepage">
  34.                   <div>
  35.                      <div>
  36.                         <h2 class="title" style="clear: both">Labeling Subversion Paths</h2>
  37.                      </div>
  38.                   </div>
  39.                </div>
  40.                <p>
  41.                   Whilst Subversion does not have a specific label entity may users follow 
  42.                   the 'tags' convention.  If a 'tag' path is pure (in that it has not had 
  43.                         subsequent changes to the content) it can be converted to a Perforce 
  44.                         label. 
  45.                       
  46.                </p>
  47.                <div class="orderedlist">
  48.                   <ol class="orderedlist" type="1">
  49.                      <li class="listitem">
  50.                         <p>
  51.                                      To enable labeling of Subversion tags, set the 
  52.                                      <em class="parameter"><code>com.p4convert.svn.labels</code></em> to 
  53.                                      <em class="parameter"><code>true</code></em> and define maps: 
  54.                                      <code class="filename">exclude.map</code> and <code class="filename">include.map</code>.
  55.                                    
  56.                         </p><pre lang="ini" class="programlisting">
  57. com.p4convert.svn.labels=true
  58. </pre></li>
  59.                      <li class="listitem">
  60.                         <p>
  61.                                      The maps are designed with resect to branches.  The default behaviour is
  62.                                      for all Subversion tag operations to be imported as Perforce branches. 
  63.                                      In order to change the behaviour and attempt to import the Subversion tag
  64.                                      as a Perforce label the path must be in the exclude map.      
  65.                                    
  66.                         </p>
  67.                         <p>
  68.                                      For example; to import all Subversion tags in the folder 'tags/' as 
  69.                                      Perforce labels, create an exclusion map file
  70.                                      <code class="filename">exclude.map</code>:
  71.                                    
  72.                         </p><pre lang="ini" class="programlisting">
  73. # exclude Subversion tags:
  74. ^tags/.*
  75. </pre></li>
  76.                      <li class="listitem">
  77.                         <p>
  78.                                      A Perforce label will need a unique name space derived from the 'tags'
  79.                                      path.  The conversion tool provides a depth and regular expression 
  80.                                      configuration option to assist.
  81.                                    
  82.                         </p><pre lang="ini" class="programlisting">
  83. com.p4convert.svn.labelFormat=svn_label:{depth}
  84. </pre><pre lang="ini" class="programlisting">
  85. com.p4convert.svn.labelDepth=2
  86. </pre><p>
  87.                                      The depth determins how much of the path to use for the unique label 
  88.                                      name.  Typically a value of '2' for convertional Subversion usage. 
  89.                                      With a depth of '2' the first two elements of the 'tags' path are then
  90.                                      held in an array and used by a regular expression to generate the label
  91.                                      name.
  92.                                    
  93.                         </p>
  94.                         <p>
  95.                                      For example, given a Subversion tag located <code class="filename">tags/1.0.0/</code>
  96.                                      the following regular expressions provide the coresponding label names:
  97.                                    
  98.                         </p><pre lang="ini" class="programlisting">
  99. com.p4convert.svn.labelFormat=label:{2}         label:1.0.0
  100. com.p4convert.svn.labelFormat={1}-{2}           tags-1.0.0
  101. </pre><div class="note admonition">
  102.                            <h3 class="title">Note</h3>
  103.                            <p>
  104.                                           An empty expression will use the original path.
  105.                                         
  106.                            </p>
  107.                         </div><pre lang="ini" class="programlisting">
  108. com.p4convert.svn.labelFormat=                  tags/1.0.0/
  109. </pre><div class="note admonition">
  110.                            <h3 class="title">Note</h3>
  111.                            <p>
  112.                                           If a keyword of <em class="parameter"><code>{depth}</code></em> is used it will be 
  113.                                           substituted with it's value.
  114.                                         
  115.                            </p>
  116.                         </div><pre lang="ini" class="programlisting">
  117. com.p4convert.svn.labelFormat=label_{depth}     label_1.0.0
  118. </pre></li>
  119.                   </ol>
  120.                </div>
  121.             </div>
  122.          </div>
  123.       </div>
  124.       <div id="nav" class="toc"></div>
  125.       <div id="search">
  126.          <div class="input"><input id="search-text" type="search" placeholder="Search this guide" /><button name="clear" type="button" class="clear"><span class="glyphicon glyphicon-remove-sign"></span></button></div>
  127.          <div class="controls">
  128.             <div class="substring"><input type="checkbox" class="substring" name="substring" value="hide" checked="1" /><span class="description">Hide partial matches</span></div>
  129.             <div class="highlighter"><input type="checkbox" class="highlight" name="highlight" value="show" checked="1" /><span class="description">Highlight matches</span></div>
  130.          </div>
  131.          <div class="count"><span class="number">0</span> matching pages
  132.                   
  133.          </div>
  134.          <ul class="results"></ul>
  135.       </div>
  136.       <div id="footer">
  137.          <div class="container"><a accesskey="p" class="nav-prev" title="Press 'p', or left-arrow, to view the previous page" href="config.filtering_subversion_paths.html"><span class="glyphicon glyphicon-chevron-left"></span><div class="label">Previous</div>
  138.                <div class="title">Filtering Subversion paths</div></a><a accesskey="n" class="nav-next" title="Press 'n', or right-arrow, to view the next page" href="config.changelist_offset_options.html"><span class="glyphicon glyphicon-chevron-right"></span><div class="label">Next</div>
  139.                <div class="title">Changelist Offset options</div></a></div>
  140.       </div><script type="text/javascript" src="vendor/jquery/jquery-1.11.3.min.js"></script><script type="text/javascript" src="vendor/bootstrap/js/bootstrap.js"></script><script type="text/javascript" src="vendor/cookie/jquery.cookie.js"></script><script type="text/javascript" src="vendor/highlight/jquery.highlight.js"></script><script type="text/javascript" src="vendor/jsrender/jsrender.js"></script><script type="text/javascript" src="vendor/touchwipe/jquery.touchwipe.min.js"></script><script type="text/javascript" src="vendor/prettify/prettify.js"></script><script defer="1" type="text/javascript" src="js/index.js"></script><script defer="1" type="text/javascript" src="js/toc.js"></script><script defer="1" type="text/javascript" src="js/perforce.js"></script></body>
  141. </html>
# Change User Description Committed
#1 13899 Paul Allen added docs to gradle 10 years ago