xan/awips2
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Deployed 4abc1932d2 with MkDocs version: 0.17.5

Browse source
This commit is contained in:
Michael James 2019-02-06 10:17:32 -07:00
parent 9ff4454aea
commit f1756c6b74
333 changed files with 79382 additions and 1039 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

28
appendix/appendix-acronyms/index.html
View file

@ -739,18 +739,6 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../python/awips-grids-and-cartopy/" title="AWIPS Grids and Cartopy" class="md-nav__link">
AWIPS Grids and Cartopy
@ -908,6 +896,18 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
@ -1661,7 +1661,7 @@
<div class="md-footer-nav">
<nav class="md-footer-nav__inner md-grid">
<a href="../appendix-grid-parameters/" title="AWIPS Grid Parameters" class="md-flex md-footer-nav__link md-footer-nav__link--prev" rel="prev">
<a href="../../python/maps-database/" title="Maps Database" class="md-flex md-footer-nav__link md-footer-nav__link--prev" rel="prev">
<div class="md-flex__cell md-flex__cell--shrink">
<i class="md-icon md-icon--arrow-back md-footer-nav__button"></i>
</div>
@ -1670,7 +1670,7 @@
<span class="md-footer-nav__direction">
Previous
</span>
AWIPS Grid Parameters
Maps Database
</span>
</div>
</a>

24
appendix/appendix-cots/index.html
View file

@ -739,18 +739,6 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../python/awips-grids-and-cartopy/" title="AWIPS Grids and Cartopy" class="md-nav__link">
AWIPS Grids and Cartopy
@ -909,6 +897,18 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../appendix-acronyms/" title="Acronyms and Abbreviations" class="md-nav__link">
Acronyms and Abbreviations

28
appendix/appendix-grid-parameters/index.html
View file

@ -739,18 +739,6 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../python/awips-grids-and-cartopy/" title="AWIPS Grids and Cartopy" class="md-nav__link">
AWIPS Grids and Cartopy
@ -916,6 +904,18 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../appendix-acronyms/" title="Acronyms and Abbreviations" class="md-nav__link">
Acronyms and Abbreviations
@ -8260,13 +8260,13 @@
</a>
<a href="../appendix-acronyms/" title="Acronyms and Abbreviations" class="md-flex md-footer-nav__link md-footer-nav__link--next" rel="next">
<a href="../../python/maps-database/" title="Maps Database" class="md-flex md-footer-nav__link md-footer-nav__link--next" rel="next">
<div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title">
<span class="md-flex__ellipsis">
<span class="md-footer-nav__direction">
Next
</span>
Acronyms and Abbreviations
Maps Database
</span>
</div>
<div class="md-flex__cell md-flex__cell--shrink">

24
appendix/appendix-wsr88d/index.html
View file

@ -739,18 +739,6 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../python/awips-grids-and-cartopy/" title="AWIPS Grids and Cartopy" class="md-nav__link">
AWIPS Grids and Cartopy
@ -909,6 +897,18 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../appendix-acronyms/" title="Acronyms and Abbreviations" class="md-nav__link">
Acronyms and Abbreviations

26
cave/bundles-and-procedures/index.html
View file

@ -848,18 +848,6 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../python/awips-grids-and-cartopy/" title="AWIPS Grids and Cartopy" class="md-nav__link">
AWIPS Grids and Cartopy
@ -1016,6 +1004,18 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../appendix/appendix-acronyms/" title="Acronyms and Abbreviations" class="md-nav__link">
Acronyms and Abbreviations
@ -1186,7 +1186,7 @@
<p>AWIPS contains two methods for saving and loading data resources: <strong>Bundles</strong> are a simple way to save loaded resources to access in future CAVE sessions. <strong>Procedures</strong> are similar to Bundles, but can be thought of a <em>groups of bundles</em> and allows the user to manage saved resources with more control.</p>
<h2 id="bundles">Bundles<a class="headerlink" href="#bundles" title="Permanent link"></a></h2>
<h3 id="file-open-bundle"><strong>File &gt; Open Bundle</strong><a class="headerlink" href="#file-open-bundle" title="Permanent link"></a></h3>
<p>Load a previously-saved bundle from within the AWIPS system. The Open Bundle dialog allows you to select your own saved bundles as well as those saved by other users (and other localization-levels such as <em>workstation</em>).</p>
<p>Load a previously-saved bundle from within the AWIPS system. The Open Bundle dialog allows you to select your own saved bundles as well as those saved by other users.</p>
<p>Each selected bundle will load its contents to new tabs which are named after the bundle file name (e.g. NAM_ThetaE)</p>
<p><img alt="image" src="../../images/KTZZHoCV5S.gif" /></p>
<p>Most saved bundles will consist of a single Map Editor (tab), but with multiple tabs saved each will open again in its own Map Editor</p>

24
cave/cave-keyboard-shortcuts/index.html
View file

@ -739,18 +739,6 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../python/awips-grids-and-cartopy/" title="AWIPS Grids and Cartopy" class="md-nav__link">
AWIPS Grids and Cartopy
@ -909,6 +897,18 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../appendix/appendix-acronyms/" title="Acronyms and Abbreviations" class="md-nav__link">
Acronyms and Abbreviations

24
cave/cave-localization/index.html
View file

@ -773,18 +773,6 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../python/awips-grids-and-cartopy/" title="AWIPS Grids and Cartopy" class="md-nav__link">
AWIPS Grids and Cartopy
@ -941,6 +929,18 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../appendix/appendix-acronyms/" title="Acronyms and Abbreviations" class="md-nav__link">
Acronyms and Abbreviations

24
cave/d2d-edit-menus/index.html
View file

@ -780,18 +780,6 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../python/awips-grids-and-cartopy/" title="AWIPS Grids and Cartopy" class="md-nav__link">
AWIPS Grids and Cartopy
@ -948,6 +936,18 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../appendix/appendix-acronyms/" title="Acronyms and Abbreviations" class="md-nav__link">
Acronyms and Abbreviations

24
cave/d2d-gis-shapefiles/index.html
View file

@ -902,18 +902,6 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../python/awips-grids-and-cartopy/" title="AWIPS Grids and Cartopy" class="md-nav__link">
AWIPS Grids and Cartopy
@ -1070,6 +1058,18 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../appendix/appendix-acronyms/" title="Acronyms and Abbreviations" class="md-nav__link">
Acronyms and Abbreviations

24
cave/d2d-gridded-models/index.html
View file

@ -882,18 +882,6 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../python/awips-grids-and-cartopy/" title="AWIPS Grids and Cartopy" class="md-nav__link">
AWIPS Grids and Cartopy
@ -1050,6 +1038,18 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../appendix/appendix-acronyms/" title="Acronyms and Abbreviations" class="md-nav__link">
Acronyms and Abbreviations

24
cave/d2d-grids/index.html
View file

@ -892,18 +892,6 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../python/awips-grids-and-cartopy/" title="AWIPS Grids and Cartopy" class="md-nav__link">
AWIPS Grids and Cartopy
@ -1060,6 +1048,18 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../appendix/appendix-acronyms/" title="Acronyms and Abbreviations" class="md-nav__link">
Acronyms and Abbreviations

24
cave/d2d-hydro/index.html
View file

@ -750,18 +750,6 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../python/awips-grids-and-cartopy/" title="AWIPS Grids and Cartopy" class="md-nav__link">
AWIPS Grids and Cartopy
@ -918,6 +906,18 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../appendix/appendix-acronyms/" title="Acronyms and Abbreviations" class="md-nav__link">
Acronyms and Abbreviations

24
cave/d2d-map-resources/index.html
View file

@ -748,18 +748,6 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../python/awips-grids-and-cartopy/" title="AWIPS Grids and Cartopy" class="md-nav__link">
AWIPS Grids and Cartopy
@ -916,6 +904,18 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../appendix/appendix-acronyms/" title="Acronyms and Abbreviations" class="md-nav__link">
Acronyms and Abbreviations

24
cave/d2d-perspective/index.html
View file

@ -868,18 +868,6 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../python/awips-grids-and-cartopy/" title="AWIPS Grids and Cartopy" class="md-nav__link">
AWIPS Grids and Cartopy
@ -1036,6 +1024,18 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../appendix/appendix-acronyms/" title="Acronyms and Abbreviations" class="md-nav__link">
Acronyms and Abbreviations

24
cave/d2d-pointdata-surface-obs/index.html
View file

@ -750,18 +750,6 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../python/awips-grids-and-cartopy/" title="AWIPS Grids and Cartopy" class="md-nav__link">
AWIPS Grids and Cartopy
@ -918,6 +906,18 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../appendix/appendix-acronyms/" title="Acronyms and Abbreviations" class="md-nav__link">
Acronyms and Abbreviations

24
cave/d2d-radar-tools/index.html
View file

@ -815,18 +815,6 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../python/awips-grids-and-cartopy/" title="AWIPS Grids and Cartopy" class="md-nav__link">
AWIPS Grids and Cartopy
@ -983,6 +971,18 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../appendix/appendix-acronyms/" title="Acronyms and Abbreviations" class="md-nav__link">
Acronyms and Abbreviations

24
cave/d2d-radar/index.html
View file

@ -750,18 +750,6 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../python/awips-grids-and-cartopy/" title="AWIPS Grids and Cartopy" class="md-nav__link">
AWIPS Grids and Cartopy
@ -918,6 +906,18 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../appendix/appendix-acronyms/" title="Acronyms and Abbreviations" class="md-nav__link">
Acronyms and Abbreviations

24
cave/d2d-satellite/index.html
View file

@ -843,18 +843,6 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../python/awips-grids-and-cartopy/" title="AWIPS Grids and Cartopy" class="md-nav__link">
AWIPS Grids and Cartopy
@ -1011,6 +999,18 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../appendix/appendix-acronyms/" title="Acronyms and Abbreviations" class="md-nav__link">
Acronyms and Abbreviations

24
cave/d2d-tools/index.html
View file

@ -878,18 +878,6 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../python/awips-grids-and-cartopy/" title="AWIPS Grids and Cartopy" class="md-nav__link">
AWIPS Grids and Cartopy
@ -1046,6 +1034,18 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../appendix/appendix-acronyms/" title="Acronyms and Abbreviations" class="md-nav__link">
Acronyms and Abbreviations

24
cave/d2d-uair/index.html
View file

@ -750,18 +750,6 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../python/awips-grids-and-cartopy/" title="AWIPS Grids and Cartopy" class="md-nav__link">
AWIPS Grids and Cartopy
@ -918,6 +906,18 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../appendix/appendix-acronyms/" title="Acronyms and Abbreviations" class="md-nav__link">
Acronyms and Abbreviations

32
cave/goes-16-satellite/index.html
View file

@ -896,18 +896,6 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../python/awips-grids-and-cartopy/" title="AWIPS Grids and Cartopy" class="md-nav__link">
AWIPS Grids and Cartopy
@ -1064,6 +1052,18 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../appendix/appendix-acronyms/" title="Acronyms and Abbreviations" class="md-nav__link">
Acronyms and Abbreviations
@ -1320,10 +1320,10 @@
<h3 id="hdf5-data-store">HDF5 Data Store<a class="headerlink" href="#hdf5-data-store" title="Permanent link"></a></h3>
<p>Decoded GOES-R satellite images are stored in <code>/awips2/edex/data/hdf5/satellite/</code> under sector subdirectories:</p>
<pre><code>drwxr-xr-x 18 awips fxalpha PRREGI
drwxr-xr-x 18 awips fxalpha TCONUS
drwxr-xr-x 18 awips fxalpha TFD
drwxr-xr-x 18 awips fxalpha TMESO-1
drwxr-xr-x 18 awips fxalpha TMESO-2
drwxr-xr-x 18 awips fxalpha ECONUS
drwxr-xr-x 18 awips fxalpha EFD
drwxr-xr-x 18 awips fxalpha EMESO-1
drwxr-xr-x 18 awips fxalpha EMESO-2
</code></pre>
<hr />
<h2 id="level-2-products">Level 2+ Products<a class="headerlink" href="#level-2-products" title="Permanent link"></a></h2>

24
cave/import-export/index.html
View file

@ -794,18 +794,6 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../python/awips-grids-and-cartopy/" title="AWIPS Grids and Cartopy" class="md-nav__link">
AWIPS Grids and Cartopy
@ -962,6 +950,18 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../appendix/appendix-acronyms/" title="Acronyms and Abbreviations" class="md-nav__link">
Acronyms and Abbreviations

49
cave/localization-perspective/index.html
View file

@ -794,18 +794,6 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../python/awips-grids-and-cartopy/" title="AWIPS Grids and Cartopy" class="md-nav__link">
AWIPS Grids and Cartopy
@ -962,6 +950,18 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../appendix/appendix-acronyms/" title="Acronyms and Abbreviations" class="md-nav__link">
Acronyms and Abbreviations
@ -1076,22 +1076,13 @@
<h1>Localization Perspective</h1>
<h2 id="localization-levels">Localization Levels<a class="headerlink" href="#localization-levels" title="Permanent link"></a></h2>
<p>AWIPS uses a hierarchical system known as <em>Localization</em> to configure many aspects of EDEX and CAVE, such as available menu items, color maps, and derived parameters. This system allows a user to override existing configurations and customize CAVE. For example, a <em>User-level</em> localization file will supercede any similar file in a lower level (such as <em>Workstation</em> or <em>Site</em>).</p>
<p>AWIPS uses a hierarchical system known as <em>Localization</em> to configure many aspects of EDEX and CAVE, such as available menu items, color maps, and derived parameters. This system allows a user to override existing configurations and customize CAVE. For example, a <em>User-level</em> localization file will supercede any similar file in a lower level (such as <em>Site</em>).</p>
<div class="admonition note">
<p class="admonition-title">There are six <em>levels of localization</em>, starting with the default <strong>BASE</strong></p>
<p class="admonition-title">There are three <em>levels of localization</em>, starting with the default <strong>BASE</strong></p>
<ul>
<li><strong>BASE</strong> - default<ul>
<li><strong>Region</strong> - a region may have many sites (generally unused)<ul>
<li><strong>Site</strong> - a site may have many desks (required)<ul>
<li><strong>Desk</strong> - a desk may have many workstations<ul>
<li><strong>Workstation</strong> - a workstation may have many users<ul>
<li><strong>User</strong> - highest level of localization, overrides all others</li>
</ul>
</li>
</ul>
</li>
</ul>
</li>
<li><strong>Site</strong> - 3-letter WFO ID (required) overrides base<ul>
<li><strong>User</strong> - user-level localization overrides site and base</li>
</ul>
</li>
</ul>
@ -1101,7 +1092,7 @@
<hr />
<h2 id="localization-editor">Localization Editor<a class="headerlink" href="#localization-editor" title="Permanent link"></a></h2>
<p>The Localization Perspective acts as file editor for the XML, Python, and text files which customize the look and feel of CAVE. </p>
<p>Users may copy and add files to available directories at the <em>Workstation</em> and <em>User</em> levels.</p>
<p>Users may copy and add files to available directories at their own <em>User</em> localization version.</p>
<p>Examples of things that can be accessed through the perspective include (this list is not all-inclusive):</p>
<ul>
<li>
@ -1123,7 +1114,7 @@
<p><img alt="image alt text" src="../../images/image_1.png" /></p>
<p>The left panel contains a directory heirarchy of CAVE files for D2D, GFE, and NCP, which can be copied and edited as <em>user</em> localization files.</p>
<p><img alt="image alt text" src="../../images/image_2.jpg" /></p>
<p>There may be several versions of each file including <strong>BASE</strong>, <strong>CONFIGURED</strong> (GFE only), <strong>SITE</strong>, <strong>WORKSTATION</strong>, and <strong>USER</strong>. Each file version is listed separately under the actual file name.</p>
<p>There may be several versions of each file including <strong>BASE</strong>, <strong>CONFIGURED</strong> (GFE only), <strong>SITE</strong>, and <strong>USER</strong>. Each file version is listed separately under the actual file name.</p>
<p>The <strong><em>File Editor</em></strong> view opens the selected configuration file in an appropriate editor. For example, a Python file is opened in a Python editor, and an XML file is opened in an XML editor.</p>
<p>--</p>
<h2 id="customizing-cave-menus">Customizing CAVE Menus<a class="headerlink" href="#customizing-cave-menus" title="Permanent link"></a></h2>
@ -1131,9 +1122,9 @@
<p>Selecting a file such as <strong>index.xml</strong> will show a sub-menu with a default localization level (typically <strong>BASE</strong> or <strong>CONFIGURED</strong>). Double-click this tab to open in the file editor (you may need to click <strong>Source</strong> at the bottom of the view to see the raw XML). Right-click this tab and select <strong>Copy To</strong> &gt; <strong>User (awips)</strong> and you will see the file localization versions update with the new copy. Select this file to edit, and override, the existing version.</p>
<p>--</p>
<h2 id="add-new-predefined-area-to-ncp">Add new Predefined Area to NCP<a class="headerlink" href="#add-new-predefined-area-to-ncp" title="Permanent link"></a></h2>
<p>In the Localization Perspective, navigate to ‘<strong>NCEP - Predefined Area Menus</strong>’, double-click ‘<strong>AreaMenus.xml</strong>’, and then right-click ‘<strong>BASE</strong>’ and select ‘<strong>Copy To - User</strong>’. You can also copy to <strong>Desk</strong> or <strong>Workstation</strong> localization.</p>
<p>In the Localization Perspective, navigate to ‘<strong>NCEP - Predefined Area Menus</strong>’, double-click ‘<strong>AreaMenus.xml</strong>’, and then right-click ‘<strong>BASE</strong>’ and select ‘<strong>Copy To - User</strong>’.</p>
<p><img alt="image alt text" src="../../images/image_4.png" /></p>
<p>You will see a new ‘<strong>USER (username)</strong>’ or <strong>‘WORKSTATION (name)’ </strong>entry for the file <strong>AreaMenus.xml</strong>. </p>
<p>You will see a new ‘<strong>USER (username)</strong>’ entry for the file <strong>AreaMenus.xml</strong>. </p>
<p><img alt="image alt text" src="../../images/image_5.png" /> </p>
<p>Double-click the new file and copy or create a new AreaMenuItem entry, such as a new CONUS Mercator projection called <strong>CONUS_Mercator</strong>:</p>
<pre><code>&lt;AreaMenuItem subMenuName="" menuName="CONUS (Mercator)"&gt;

24
cave/maps-views-projections/index.html
View file

@ -787,18 +787,6 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../python/awips-grids-and-cartopy/" title="AWIPS Grids and Cartopy" class="md-nav__link">
AWIPS Grids and Cartopy
@ -955,6 +943,18 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../appendix/appendix-acronyms/" title="Acronyms and Abbreviations" class="md-nav__link">
Acronyms and Abbreviations

24
cave/ncp-perspective/index.html
View file

@ -840,18 +840,6 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../python/awips-grids-and-cartopy/" title="AWIPS Grids and Cartopy" class="md-nav__link">
AWIPS Grids and Cartopy
@ -1008,6 +996,18 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../appendix/appendix-acronyms/" title="Acronyms and Abbreviations" class="md-nav__link">
Acronyms and Abbreviations

24
cave/nsharp/index.html
View file

@ -826,18 +826,6 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../python/awips-grids-and-cartopy/" title="AWIPS Grids and Cartopy" class="md-nav__link">
AWIPS Grids and Cartopy
@ -994,6 +982,18 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../appendix/appendix-acronyms/" title="Acronyms and Abbreviations" class="md-nav__link">
Acronyms and Abbreviations

24
cave/warngen/index.html
View file

@ -850,18 +850,6 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../python/awips-grids-and-cartopy/" title="AWIPS Grids and Cartopy" class="md-nav__link">
AWIPS Grids and Cartopy
@ -1018,6 +1006,18 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../appendix/appendix-acronyms/" title="Acronyms and Abbreviations" class="md-nav__link">
Acronyms and Abbreviations

24
dev/awips-development-environment/index.html
View file

@ -739,18 +739,6 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../python/awips-grids-and-cartopy/" title="AWIPS Grids and Cartopy" class="md-nav__link">
AWIPS Grids and Cartopy
@ -916,6 +904,18 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../appendix/appendix-acronyms/" title="Acronyms and Abbreviations" class="md-nav__link">
Acronyms and Abbreviations

24
edex/case-studies/index.html
View file

@ -825,18 +825,6 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../python/awips-grids-and-cartopy/" title="AWIPS Grids and Cartopy" class="md-nav__link">
AWIPS Grids and Cartopy
@ -993,6 +981,18 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../appendix/appendix-acronyms/" title="Acronyms and Abbreviations" class="md-nav__link">
Acronyms and Abbreviations

24
edex/data-distribution-files/index.html
View file

@ -814,18 +814,6 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../python/awips-grids-and-cartopy/" title="AWIPS Grids and Cartopy" class="md-nav__link">
AWIPS Grids and Cartopy
@ -982,6 +970,18 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../appendix/appendix-acronyms/" title="Acronyms and Abbreviations" class="md-nav__link">
Acronyms and Abbreviations

24
edex/data-plugins/index.html
View file

@ -791,18 +791,6 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../python/awips-grids-and-cartopy/" title="AWIPS Grids and Cartopy" class="md-nav__link">
AWIPS Grids and Cartopy
@ -959,6 +947,18 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../appendix/appendix-acronyms/" title="Acronyms and Abbreviations" class="md-nav__link">
Acronyms and Abbreviations

28
edex/data-purge/index.html
View file

@ -801,18 +801,6 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../python/awips-grids-and-cartopy/" title="AWIPS Grids and Cartopy" class="md-nav__link">
AWIPS Grids and Cartopy
@ -969,6 +957,18 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../appendix/appendix-acronyms/" title="Acronyms and Abbreviations" class="md-nav__link">
Acronyms and Abbreviations
@ -1145,14 +1145,12 @@ INFO 2012-03-27 00:31:23,155 [DefaultQuartzScheduler_Worker-3] PurgeLogger: EDE
INFO 2012-03-27 00:31:23,155 [DefaultQuartzScheduler_Worker-3] PurgeLogger: EDEX - PURGE LOGS::---------END LOG PURGE-----------
</code></pre>
<h2 id="all-purge-rules">All Purge Rules<a class="headerlink" href="#all-purge-rules" title="Permanent link"></a></h2>
<p>To see all purge rule directories (base, site, region, configured):</p>
<p>To see all purge rule directories (base, site, configured):</p>
<pre><code>find /awips2/edex/data/utility -name purge
/awips2/edex/data/utility/edex_static/region/CR/purge
/awips2/edex/data/utility/edex_static/base/purge
/awips2/edex/data/utility/edex_static/configured/OAX/purge
/awips2/edex/data/utility/edex_static/site/OAX/purge
/awips2/edex/data/utility/common_static/region/CR/purge
/awips2/edex/data/utility/common_static/base/purge
/awips2/edex/data/utility/common_static/configured/OAX/purge
/awips2/edex/data/utility/common_static/site/AFC/purge

24
edex/distributed-computing/index.html
View file

@ -862,18 +862,6 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../python/awips-grids-and-cartopy/" title="AWIPS Grids and Cartopy" class="md-nav__link">
AWIPS Grids and Cartopy
@ -1030,6 +1018,18 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../appendix/appendix-acronyms/" title="Acronyms and Abbreviations" class="md-nav__link">
Acronyms and Abbreviations

24
edex/edex-ingest-docker-container/index.html
View file

@ -794,18 +794,6 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../python/awips-grids-and-cartopy/" title="AWIPS Grids and Cartopy" class="md-nav__link">
AWIPS Grids and Cartopy
@ -962,6 +950,18 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../appendix/appendix-acronyms/" title="Acronyms and Abbreviations" class="md-nav__link">
Acronyms and Abbreviations

24
edex/edex-users/index.html
View file

@ -750,18 +750,6 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../python/awips-grids-and-cartopy/" title="AWIPS Grids and Cartopy" class="md-nav__link">
AWIPS Grids and Cartopy
@ -918,6 +906,18 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../appendix/appendix-acronyms/" title="Acronyms and Abbreviations" class="md-nav__link">
Acronyms and Abbreviations

24
edex/ldm/index.html
View file

@ -801,18 +801,6 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../python/awips-grids-and-cartopy/" title="AWIPS Grids and Cartopy" class="md-nav__link">
AWIPS Grids and Cartopy
@ -969,6 +957,18 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../appendix/appendix-acronyms/" title="Acronyms and Abbreviations" class="md-nav__link">
Acronyms and Abbreviations

24
edex/new-grid/index.html
View file

@ -801,18 +801,6 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../python/awips-grids-and-cartopy/" title="AWIPS Grids and Cartopy" class="md-nav__link">
AWIPS Grids and Cartopy
@ -969,6 +957,18 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../appendix/appendix-acronyms/" title="Acronyms and Abbreviations" class="md-nav__link">
Acronyms and Abbreviations

24
edex/settings/index.html
View file

@ -787,18 +787,6 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../python/awips-grids-and-cartopy/" title="AWIPS Grids and Cartopy" class="md-nav__link">
AWIPS Grids and Cartopy
@ -955,6 +943,18 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../appendix/appendix-acronyms/" title="Acronyms and Abbreviations" class="md-nav__link">
Acronyms and Abbreviations

BIN
images/gempak-d2d.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 398 KiB

24
index.html
View file

@ -868,18 +868,6 @@
<li class="md-nav__item">
<a href="python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="python/awips-grids-and-cartopy/" title="AWIPS Grids and Cartopy" class="md-nav__link">
AWIPS Grids and Cartopy
@ -1036,6 +1024,18 @@
<li class="md-nav__item">
<a href="python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="appendix/appendix-acronyms/" title="Acronyms and Abbreviations" class="md-nav__link">
Acronyms and Abbreviations

34
install/install-cave/index.html
View file

@ -802,18 +802,6 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../python/awips-grids-and-cartopy/" title="AWIPS Grids and Cartopy" class="md-nav__link">
AWIPS Grids and Cartopy
@ -970,6 +958,18 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../appendix/appendix-acronyms/" title="Acronyms and Abbreviations" class="md-nav__link">
Acronyms and Abbreviations
@ -1097,7 +1097,7 @@
<h2 id="download-and-install-cave">Download and Install CAVE<a class="headerlink" href="#download-and-install-cave" title="Permanent link"></a></h2>
<blockquote>
<p><a href="https://www.unidata.ucar.edu/blogs/news/category/AWIPS">Release 18.1.1-1, September 20, 2018</a></p>
<p><a href="https://www.unidata.ucar.edu/blogs/news/category/AWIPS">Release 18.1.1-5, February 6, 2019</a></p>
</blockquote>
<h2 id="linux">Linux<a class="headerlink" href="#linux" title="Permanent link"></a></h2>
<table>
@ -1110,7 +1110,7 @@
<tbody>
<tr>
<td align="center"><h1><i class="fa fa-linux"></i></h1></td>
<td align="left"><h4><a href="https://www.unidata.ucar.edu/software/awips2/awips_install.sh">awips_install.sh --cave <i class="fa fa-download"></i></a> </h4> <p>For CentOS/Red Hat 6 and 7. Installs to /awips2/cave and writes files to ~/caveData.</p> <tt><code>chmod 755 awips_install.sh<br>sudo ./aiwps_install.sh --cave</code></tt><p>Run CAVE from the Linux Desktop menu Applications &gt; Internet &gt; AWIPS CAVE, or from the command line as simply <code>cave</code>.</p> <div class="admonition note"><p class="admonition-title">System Requirements</p><ul><li>x86_64 CentOS/RHEL 6 or 7</li><li>OpenGL 2.0 capable device</li><li>4GB RAM</li><li><a href="http://www.nvidia.com/Download/index.aspx?lang=en-us">Latest NVIDIA driver</a></li><li>approx. 2GB disk space for data caching (~/caveData)</li></ul></div><p>You can reset CAVE at any time by removing the <strong>~/caveData</strong> directory (on macOS <strong>~/Library/caveData</strong>) and reconnecting to an EDEX server. </p></td>
<td align="left"><h4><a href="https://www.unidata.ucar.edu/software/awips2/awips_install.sh">awips_install.sh --cave <i class="fa fa-download"></i></a> </h4> <p>For CentOS/Red Hat 6 and 7. Installs to /awips2/cave and writes files to ~/caveData.</p> <tt><code>chmod 755 awips_install.sh<br>sudo ./awips_install.sh --cave</code></tt><p>Run CAVE from the Linux Desktop menu Applications &gt; Internet &gt; AWIPS CAVE, or from the command line as simply <code>cave</code>.</p> <div class="admonition note"><p class="admonition-title">System Requirements</p><ul><li>x86_64 CentOS/RHEL 6 or 7</li><li>OpenGL 2.0 capable device</li><li>4GB RAM</li><li><a href="http://www.nvidia.com/Download/index.aspx?lang=en-us">Latest NVIDIA driver</a></li><li>approx. 2GB disk space for data caching (~/caveData)</li></ul></div><p>You can reset CAVE at any time by removing the <strong>~/caveData</strong> directory (on macOS <strong>~/Library/caveData</strong>) and reconnecting to an EDEX server. </p></td>
</tr>
</tbody>
</table>
@ -1125,7 +1125,7 @@
<tbody>
<tr>
<td align="center"><h1><i class="fa fa-apple"></i></h1></td>
<td align="left"><h4> Download and install both<br><a href="https://www.unidata.ucar.edu/downloads/awips2/awips-cave-18.1.1-1.dmg">awips-cave-18.1.1-1.dmg <i class="fa fa-download"></i></a><br><a href="https://www.unidata.ucar.edu/downloads/awips2/awips-python.pkg">awips-python.pkg <i class="fa fa-download"></i></a></h4> <p><strong>Supported Graphics Devices for macOS</strong><li>Intel HD Graphics</li><li>Intel Iris</li><li>NVIDIA GeForce</li></p><p><strong>Unsupported Graphics Devices for macOS</strong><li>AMD Radeon R9</li><li>AMD Radeon Pro</li><li>AMD FirePro D300</li></p> <p>Writes and syncs files to ~/Library/caveData.</p> <p><strong>awips-python.pkg</strong> is not a prerequisite, and CAVE will still run and display data without it, but to use any derived parameter functions such as wind barbs/arrows and grid parameters on various vertical coordinates, jep must be installed in some way (it is assumed in /Library/Python/2.7/site-packages/jep/)</p></td>
<td align="left"><h4> Download and install both<br><a href="https://www.unidata.ucar.edu/downloads/awips2/awips-cave.dmg">awips-cave.dmg <i class="fa fa-download"></i></a><br><a href="https://www.unidata.ucar.edu/downloads/awips2/awips-python.pkg">awips-python.pkg <i class="fa fa-download"></i></a></h4> <p><strong>Supported Graphics Devices for macOS</strong><li>Intel HD Graphics</li><li>Intel Iris</li><li>NVIDIA GeForce</li></p><p><strong>Unsupported Graphics Devices for macOS</strong><li>AMD Radeon R9</li><li>AMD Radeon Pro</li><li>AMD FirePro D300</li></p> <p>Writes and syncs files to ~/Library/caveData.</p> <p><strong>awips-python.pkg</strong> is not a prerequisite, and CAVE will still run and display data without it, but to use any derived parameter functions such as wind barbs/arrows and grid parameters on various vertical coordinates, jep must be installed in some way (it is assumed in /Library/Python/2.7/site-packages/jep/)</p></td>
</tr>
</tbody>
</table>
@ -1140,14 +1140,14 @@
<tbody>
<tr>
<td align="center"><h1><i class="fa fa-windows"></i> </h1></td>
<td align="left"><h4> <a href="https://www.unidata.ucar.edu/downloads/awips2/awips-cave-18.1.1-1.msi">awips-cave-18.1.1-1.msi <i class="fa fa-download"></i></a></h4><p>Writes files to <strong>~/caveData</strong> (in your user home directory)</p> <p>Requires <b>Python 3</b>, <b>Numpy</b>, and <b>Jep</b> be installed</p> <p>Requires <strong>PYTHONHOME</strong> be defined</p> <p>In addition to the application directory, the MSI installer will attempt to copy the <em><a href="https://github.com/mjames-upc/gridslice">gridslice</a></em> shared library to <code>$PYTHONHOME/Dlls</code>. If the <code>$PYTHONHOME</code> environmental variable is not defined, <em>gridslice</em> will not be installed. You can always rerun the installer after defining <code>$PYTHONHOME</code> and then check that the file <code>gridslice.pyd</code> is installed in <code>$PYTHONHOME/Dlls</code>.</p> <p>CAVE will still run without gridslice, but certain bundles which use derived parameters, such as <a href="../../cave/d2d-grids/#isentopic-analysis-270k-320k">isentropic analyses</a>, will not load. </p></td>
<td align="left"><h4> <a href="https://www.unidata.ucar.edu/downloads/awips2/awips-cave.msi">awips-cave.msi <i class="fa fa-download"></i></a></h4><p>Writes files to <strong>~/caveData</strong> (in your user home directory)</p> <p>Requires <b>Python 3</b>, <b>Numpy</b>, and <b>Jep</b> be installed</p> <p>Requires <strong>PYTHONHOME</strong> be defined</p> <p>In addition to the application directory, the MSI installer will attempt to copy the <em><a href="https://github.com/mjames-upc/gridslice">gridslice</a></em> shared library to <code>$PYTHONHOME/Dlls</code>. If the <code>$PYTHONHOME</code> environmental variable is not defined, <em>gridslice</em> will not be installed. You can always rerun the installer after defining <code>$PYTHONHOME</code> and then check that the file <code>gridslice.pyd</code> is installed in <code>$PYTHONHOME/Dlls</code>.</p> <p>CAVE will still run without gridslice, but certain bundles which use derived parameters, such as <a href="../../cave/d2d-grids/#isentopic-analysis-270k-320k">isentropic analyses</a>, will not load. </p></td>
</tr>
</tbody>
</table>
<p><b>Windows-Specific Instructions</b></p>
<div class="admonition note">
<h4>1) Download and install <strong><a href="https://conda.io/miniconda.html">Miniconda Python 3.7 for Windows</a></strong><a class="headerlink" href="#1-download-and-install-miniconda-python-37-for-windows" title="Permanent link"></a></h4><ul><li>Allow Miniconda3 to set <strong>PATH</strong> and other environment variables.</li><li><p>Ensure that <strong>PYTHONHOME</strong> is set to the Miniconda3 location.</p><p><img alt="" src="../../images/windows_envvars.png" /></p><p>If <strong>PYTHONHOME</strong> is not set, the <strong>gridslice</strong> Python module will not be installed or available.</p></li></ul><h4>2) Install dependent Python packages</h4><ul><li><code>pip install numpy==1.15.1 jep==3.8.2</code></li></ul><h4>3) Run <a href="https://www.unidata.ucar.edu/downloads/awips2/awips-cave-18.1.1-1.msi">awips-cave-18.1.1-1.msi <i class="fa fa-download"></i></a><a class="headerlink" href="#3-run-awips-cave-1811-1amd64msi" title="Permanent link"></a></h4>
<h4>1) Download and install <strong><a href="https://conda.io/miniconda.html">Miniconda Python 3.7 for Windows</a></strong><a class="headerlink" href="#1-download-and-install-miniconda-python-37-for-windows" title="Permanent link"></a></h4><ul><li>Allow Miniconda3 to set <strong>PATH</strong> and other environment variables.</li><li><p>Ensure that <strong>PYTHONHOME</strong> is set to the Miniconda3 location.</p><p><img alt="" src="../../images/windows_envvars.png" /></p><p>If <strong>PYTHONHOME</strong> is not set, the <strong>gridslice</strong> Python module will not be installed or available.</p></li></ul><h4>2) Install dependent Python packages</h4><ul><li><code>pip install numpy==1.15.1 jep==3.8.2</code></li></ul><h4>3) Run <a href="https://www.unidata.ucar.edu/downloads/awips2/awips-cave.msi">awips-cave.msi <i class="fa fa-download"></i></a><a class="headerlink" href="#3-run-awips-cave-1amd64msi" title="Permanent link"></a></h4>
</div>
<hr />

32
install/install-edex/index.html
View file

@ -883,18 +883,6 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../python/awips-grids-and-cartopy/" title="AWIPS Grids and Cartopy" class="md-nav__link">
AWIPS Grids and Cartopy
@ -1051,6 +1039,18 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../appendix/appendix-acronyms/" title="Acronyms and Abbreviations" class="md-nav__link">
Acronyms and Abbreviations
@ -1259,7 +1259,7 @@
<h2 id="download-and-install-edex">Download and Install EDEX<a class="headerlink" href="#download-and-install-edex" title="Permanent link"></a></h2>
<blockquote>
<p><a href="https://www.unidata.ucar.edu/blogs/news/category/AWIPS">Release 18.1.1-1, September 20, 2018</a></p>
<p><a href="https://www.unidata.ucar.edu/blogs/news/category/AWIPS">Release 18.1.1-5, February 6, 2019</a></p>
</blockquote>
<table>
<thead>
@ -1271,7 +1271,7 @@
<tbody>
<tr>
<td align="center"><h1><i class="fa fa-linux"></i> Linux </h1></td>
<td align="left"><h4><a href="https://www.unidata.ucar.edu/software/awips2/awips_install.sh">aiwps_install.sh --edex <i class="fa fa-download"></i></a> </h4> <p>Installs to /awips2/ directories.</p> <tt><code>chmod 755 awips_install.sh<br>sudo ./awips_install.sh --edex</code></tt><p>Start and Stop:</p><p><tt>edex start<br>edex stop</tt></p><div class="admonition note"><p class="admonition-title">System Requirements</p><ul><li>x86_64 CentOS/RHEL 6 or 7</li><li>16+ CPU cores (each CPU core is one more decoder which can run in parallel)</li><li>24GB RAM</li><li>700GB+ disk space</li><li>A <strong>Solid State Drive (SSD)</strong> is highly recommended</li></ul></div> <p>An <strong>SSD</strong> should be mounted either to <code>/awips2</code> (to contain the entire EDEX system) or to <code>/awips2/edex/data/hdf5</code> (to contain the large files in the decoded data store). EDEX can scale to any system by adjusting the incoming LDM data feeds or adjusting the resources (CPU threads) allocated to each data type.</p><p><strong>64-bit CentOS/RHEL 6 and 7</strong> are the only supported operating systems for EDEX. You may have luck with Fedora Core 12 to 14 and Scientific Linux.</p><p>EDEX is not supported on Debian, Ubuntu, SUSE, Solaris, OS X, or Windows.</p></td>
<td align="left"><h4><a href="https://www.unidata.ucar.edu/software/awips2/awips_install.sh">awips_install.sh --edex <i class="fa fa-download"></i></a> </h4> <p>Installs to /awips2/ directories.</p> <tt><code>chmod 755 awips_install.sh<br>sudo ./awips_install.sh --edex</code></tt><p>Start and Stop:</p><p><tt>edex start<br>edex stop</tt></p><div class="admonition note"><p class="admonition-title">System Requirements</p><ul><li>x86_64 CentOS/RHEL 6 or 7</li><li>16+ CPU cores (each CPU core is one more decoder which can run in parallel)</li><li>24GB RAM</li><li>700GB+ disk space</li><li>A <strong>Solid State Drive (SSD)</strong> is highly recommended</li></ul></div> <p>An <strong>SSD</strong> should be mounted either to <code>/awips2</code> (to contain the entire EDEX system) or to <code>/awips2/edex/data/hdf5</code> (to contain the large files in the decoded data store). EDEX can scale to any system by adjusting the incoming LDM data feeds or adjusting the resources (CPU threads) allocated to each data type.</p><p><strong>64-bit CentOS/RHEL 6 and 7</strong> are the only supported operating systems for EDEX. You may have luck with Fedora Core 12 to 14 and Scientific Linux.</p><p>EDEX is not supported on Debian, Ubuntu, SUSE, Solaris, OS X, or Windows.</p></td>
</tr>
</tbody>
</table>
@ -1297,6 +1297,7 @@
chmod 755 awips_install.sh
sudo ./awips_install.sh --edex
</code></pre>
<p>/usr/bin/edex setup</p>
<div class="admonition note">
<p class="admonition-title"><strong>awips_install.sh --edex</strong> will perform the following steps (it's always a good idea to review downloaded shell scripts):</p>
<ol>
@ -1388,8 +1389,7 @@ Failed to restart iptables.service: Unit iptables.service failed to load: No suc
</blockquote>
<h3 id="5-start-edex">5. Start EDEX<a class="headerlink" href="#5-start-edex" title="Permanent link"></a></h3>
<blockquote>
<pre><code> edex setup
edex start
<pre><code> edex start
</code></pre>
<p>To manually start, stop, and restart:</p>
<pre><code> service edex_postgres start

24
install/start-edex/index.html
View file

@ -821,18 +821,6 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../python/awips-grids-and-cartopy/" title="AWIPS Grids and Cartopy" class="md-nav__link">
AWIPS Grids and Cartopy
@ -989,6 +977,18 @@
<li class="md-nav__item">
<a href="../../python/maps-database/" title="Maps Database" class="md-nav__link">
Maps Database
</a>
</li>
<li class="md-nav__item">
<a href="../../appendix/appendix-acronyms/" title="Acronyms and Abbreviations" class="md-nav__link">
Acronyms and Abbreviations

2
mkdocs.yml
View file

@ -74,7 +74,6 @@ pages:
- Map Overlays: cave/d2d-map-resources.md
- Python API:
- Overview: python/python-awips-data-access.md
- Maps Database: python/maps-database.md
- AWIPS Grids and Cartopy: python/awips-grids-and-cartopy.md
- Satellite Imagery: python/satellite-imagery.md
- NEXRAD Level 3 Radar: python/nexrad-level-3-radar.md
@ -86,6 +85,7 @@ pages:
- AWIPS Development Environment (ADE): dev/awips-development-environment.md
- Appendix:
- AWIPS Grid Parameters: appendix/appendix-grid-parameters.md
- Maps Database: python/maps-database.md
- Acronyms and Abbreviations: appendix/appendix-acronyms.md
- COTS and FOSS: appendix/appendix-cots.md
- WSR-88D Product Table: appendix/appendix-wsr88d.md

BIN
pdf/A2_SVD_OB17.1.1.pdf Normal file
View file

Binary file not shown.

BIN
pdf/AWP.FT.SWCTR.ADE-16.00.pdf Normal file
View file

Binary file not shown.

BIN
pdf/AWP.RLSN.OB17.1.1 - FINAL.pdf Normal file
View file

Binary file not shown.

BIN
pdf/NWS_Documentation/A2_SVD_OB17.1.1.xls Normal file
View file

Binary file not shown.

BIN
pdf/NWS_Documentation/AWP.DSN.A2.SSDD-08.00.zip Normal file
View file

Binary file not shown.

BIN
pdf/NWS_Documentation/D2D Procedure Conversion/D2D Bundle Conversion.docx Normal file
View file

Binary file not shown.

BIN
pdf/NWS_Documentation/GFE Migration/D2DGridsinGFE.docx Normal file
View file

Binary file not shown.

BIN
pdf/NWS_Documentation/GFE Migration/GfeClient/PublishingGfeGrids.docx Normal file
View file

Binary file not shown.

BIN
pdf/NWS_Documentation/GFE Migration/GfeClient/gfeClient PngWriter.docx Normal file
View file

Binary file not shown.

BIN
pdf/NWS_Documentation/GFE Migration/GfeClient/gfeClient TextProductTest.docx Normal file
View file

Binary file not shown.

BIN
pdf/NWS_Documentation/GFE Migration/GfeClient/gfeClient runProcedure.docx Normal file
View file

Binary file not shown.

BIN
pdf/NWS_Documentation/GFE Migration/GfeClient/gfeClient.docx Normal file
View file

Binary file not shown.

BIN
pdf/NWS_Documentation/GFE Migration/Links/AppCheckForPointTools.docx Normal file
View file

Binary file not shown.

BIN
pdf/NWS_Documentation/GFE Migration/Links/AppConvertEditAreas.docx Normal file
View file

Binary file not shown.

BIN
pdf/NWS_Documentation/GFE Migration/Links/AppGfeAfpsProxy.docx Normal file
View file

Binary file not shown.

BIN
pdf/NWS_Documentation/GFE Migration/Links/BaseSiteUserDirs.docx Normal file
View file

Binary file not shown.

BIN
pdf/NWS_Documentation/GFE Migration/Links/CommonSmartToolChanges.docx Normal file
View file

Binary file not shown.

BIN
pdf/NWS_Documentation/GFE Migration/Links/GFErename modules.docx Normal file
View file

Binary file not shown.

BIN
pdf/NWS_Documentation/GFE Migration/Links/GfeActivateSite.docx Normal file
View file

Binary file not shown.

BIN
pdf/NWS_Documentation/GFE Migration/Links/GfeConfigMaps.docx Normal file
View file

Binary file not shown.

BIN
pdf/NWS_Documentation/GFE Migration/Links/GfeModuleInstaller.sh.docx Normal file
View file

Binary file not shown.

BIN
pdf/NWS_Documentation/GFE Migration/Links/HowToGfePortingNotes.docx Normal file
View file

Binary file not shown.

BIN
pdf/NWS_Documentation/GFE Migration/Links/HowToImportShapefile.docx Normal file
View file

Binary file not shown.

BIN
pdf/NWS_Documentation/GFE Migration/Links/MultiModelSmartInits.docx Normal file
View file

Binary file not shown.

BIN
pdf/NWS_Documentation/GFE Migration/Links/NCLADT Repository.docx Normal file
View file

Binary file not shown.

BIN
pdf/NWS_Documentation/GFE Migration/Links/NumericToNumpy.docx Normal file
View file

Binary file not shown.

BIN
pdf/NWS_Documentation/GFE Migration/Links/SmartScriptDifferences.docx Normal file
View file

Binary file not shown.

BIN
pdf/NWS_Documentation/GFE Migration/Links/SmartScriptIssues.docx Normal file
View file

Binary file not shown.

BIN
pdf/NWS_Documentation/GFE Migration/Links/SmartScriptUsageAnalysis.docx Normal file
View file

Binary file not shown.

BIN
pdf/NWS_Documentation/GFE Migration/Links/checkForPointTools doc.docx Normal file
View file

Binary file not shown.

BIN
pdf/NWS_Documentation/GFE Migration/Links/findAdamGfeFile.docx Normal file
View file

Binary file not shown.

BIN
pdf/NWS_Documentation/GFE Migration/Links/gfeConfigFileChanges.docx Normal file
View file

Binary file not shown.

BIN
pdf/NWS_Documentation/GFE Migration/Links/gfePorter.docx Normal file
View file

Binary file not shown.

BIN
pdf/NWS_Documentation/LDM Ingest/Ingest Filter Configuration.docx Normal file
View file

Binary file not shown.

BIN
pdf/NWS_Documentation/LDM Ingest/LDM Ingest Checklist.docx Normal file
View file

Binary file not shown.

BIN
pdf/NWS_Documentation/Local Applications/Adding Local Grids_v2.pdf Normal file
View file

Binary file not shown.

BIN
pdf/NWS_Documentation/Local Applications/Local Applications Guide.docx Normal file
View file

Binary file not shown.

BIN
pdf/NWS_Documentation/Local Applications/Local Apps working session - migration.docx Normal file
View file

Binary file not shown.

BIN
pdf/NWS_Documentation/Localization Doc References/A2_SDC_Localization_Guide.pdf Normal file
View file

Binary file not shown.

BIN
pdf/NWS_Documentation/Localization Doc References/ADAM SDC AutoTool functions.docx Normal file
View file

Binary file not shown.

BIN
pdf/NWS_Documentation/Localization Doc References/ADAM SDC Autotool Log File.docx Normal file
View file

Binary file not shown.

BIN
pdf/NWS_Documentation/Localization Doc References/Table 5.3-1.docx Normal file
View file

Binary file not shown.

BIN
pdf/NWS_Documentation/Organization Aids/A2 Site Mig Org Aids_v8.xlsm Normal file
View file

Binary file not shown.

108
pdf/NWS_Documentation/Subversion/1. 7 svn-book-html-chunk/SV07BE~1.HTM Normal file
View file

@ -0,0 +1,108 @@
<?xml version="1.0" encoding="utf-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>svnadmin list-unused-dblogs</title>
<link rel="stylesheet" href="styles.css" type="text/css" />
<meta name="generator" content="DocBook XSL Stylesheets V1.75.2" />
<style type="text/css">
body { background-image: url('images/draft.png');
background-repeat: no-repeat;
background-position: top left;
/* The following properties make the watermark "fixed" on the page. */
/* I think that's just a bit too distracting for the reader... */
/* background-attachment: fixed; */
/* background-position: center center; */
}</style>
<link rel="home" href="index.html" title="Version Control with Subversion [DRAFT]" />
<link rel="up" href="svn.ref.svnadmin.html#svn.ref.svnadmin.c" title="svnadmin Subcommands" />
<link rel="prev" href="svn.ref.svnadmin.c.list-dblogs.html" title="svnadmin list-dblogs" />
<link rel="next" href="svn.ref.svnadmin.c.load.html" title="svnadmin load" />
</head>
<body>
<div class="navheader">
<table width="100%" summary="Navigation header">
<tr>
<th colspan="3" align="center">svnadmin list-unused-dblogs</th>
</tr>
<tr>
<td width="20%" align="left"><a accesskey="p" href="svn.ref.svnadmin.c.list-dblogs.html">Prev</a> </td>
<th width="60%" align="center">svnadmin Subcommands</th>
<td width="20%" align="right"> <a accesskey="n" href="svn.ref.svnadmin.c.load.html">Next</a></td>
</tr>
</table>
<hr />
</div>
<div class="refentry" title="svnadmin list-unused-dblogs">
<a id="svn.ref.svnadmin.c.list-unused-dblogs"></a>
<div class="titlepage"></div>
<a id="idp43727536" class="indexterm"></a>
<div class="refnamediv">
<h2>Name</h2>
<p>svnadmin list-unused-dblogs — Ask Berkeley DB which logfiles can be safely
deleted (applies only to repositories using the
<code class="literal">bdb</code> backend).</p>
</div>
<div class="refsect1" title="Synopsis">
<a id="idp43731424"></a>
<h2>Synopsis</h2>
<p>
<code class="literal">svnadmin list-unused-dblogs REPOS_PATH</code>
</p>
</div>
<div class="refsect1" title="Description">
<a id="idp43733056"></a>
<h2>Description</h2>
<p>Berkeley DB creates logs of all changes to the
repository, which allow it to recover in the face of
catastrophe. Unless you enable
<code class="literal">DB_LOG_AUTOREMOVE</code>, the logfiles
accumulate, although most are no longer used and can be
deleted to reclaim disk space. See <a class="xref" href="svn.reposadmin.maint.html#svn.reposadmin.maint.diskspace" title="Managing Disk Space">the section called “Managing Disk Space”</a> for more
information.</p>
</div>
<div class="refsect1" title="Examples">
<a id="idp43735984"></a>
<h2>Examples</h2>
<p>Remove all unused logfiles from the repository:</p>
<div class="informalexample">
<pre class="screen">
$ svnadmin list-unused-dblogs /var/svn/repos
/var/svn/repos/log.0000000031
/var/svn/repos/log.0000000032
/var/svn/repos/log.0000000033
$ svnadmin list-unused-dblogs /var/svn/repos | xargs rm
## disk space reclaimed!
</pre>
</div>
</div>
</div>
<div class="navfooter">
<hr />
<table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left"><a accesskey="p" href="svn.ref.svnadmin.c.list-dblogs.html">Prev</a> </td>
<td width="20%" align="center">
<a accesskey="u" href="svn.ref.svnadmin.html#svn.ref.svnadmin.c">Up</a>
</td>
<td width="40%" align="right"> <a accesskey="n" href="svn.ref.svnadmin.c.load.html">Next</a></td>
</tr>
<tr>
<td width="40%" align="left" valign="top">svnadmin list-dblogs </td>
<td width="20%" align="center">
<a accesskey="h" href="index.html">Home</a>
</td>
<td width="40%" align="right" valign="top"> svnadmin load</td>
</tr>
</table>
</div>
<div xmlns="" id="svn-footer">
<hr />
<p>You are reading <em>Version Control with Subversion</em> (for Subversion 1.7), by Ben Collins-Sussman, Brian W. Fitzpatrick, and C. Michael Pilato.<br />
This work is licensed under the <a href="http://creativecommons.org/licenses/by/2.0/">Creative Commons Attribution License v2.0</a>.<br />
To submit comments, corrections, or other contributions to the text, please visit <a href="http://www.svnbook.com/">http://www.svnbook.com/</a>.</p>
</div>
</body>
</html>

110
pdf/NWS_Documentation/Subversion/1. 7 svn-book-html-chunk/SV089E~1.HTM Normal file
View file

@ -0,0 +1,110 @@
<?xml version="1.0" encoding="utf-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>svnlook propget</title>
<link rel="stylesheet" href="styles.css" type="text/css" />
<meta name="generator" content="DocBook XSL Stylesheets V1.75.2" />
<style type="text/css">
body { background-image: url('images/draft.png');
background-repeat: no-repeat;
background-position: top left;
/* The following properties make the watermark "fixed" on the page. */
/* I think that's just a bit too distracting for the reader... */
/* background-attachment: fixed; */
/* background-position: center center; */
}</style>
<link rel="home" href="index.html" title="Version Control with Subversion [DRAFT]" />
<link rel="up" href="svn.ref.svnlook.html#svn.ref.svnlook.c" title="svnlook Subcommands" />
<link rel="prev" href="svn.ref.svnlook.c.log.html" title="svnlook log" />
<link rel="next" href="svn.ref.svnlook.c.proplist.html" title="svnlook proplist" />
</head>
<body>
<div class="navheader">
<table width="100%" summary="Navigation header">
<tr>
<th colspan="3" align="center">svnlook propget</th>
</tr>
<tr>
<td width="20%" align="left"><a accesskey="p" href="svn.ref.svnlook.c.log.html">Prev</a> </td>
<th width="60%" align="center">svnlook Subcommands</th>
<td width="20%" align="right"> <a accesskey="n" href="svn.ref.svnlook.c.proplist.html">Next</a></td>
</tr>
</table>
<hr />
</div>
<div class="refentry" title="svnlook propget">
<a id="svn.ref.svnlook.c.propget"></a>
<div class="titlepage"></div>
<a id="idp44119760" class="indexterm"></a>
<div class="refnamediv">
<h2>Name</h2>
<p>svnlook propget, pget, pg — Print the raw value of a property on a path in
the repository.</p>
</div>
<div class="refsect1" title="Synopsis">
<a id="idp44123744"></a>
<h2>Synopsis</h2>
<p>
<code class="literal">svnlook propget REPOS_PATH PROPNAME [PATH_IN_REPOS]</code>
</p>
</div>
<div class="refsect1" title="Description">
<a id="idp44125392"></a>
<h2>Description</h2>
<p>List the value of a property on a path in the
repository.</p>
</div>
<div class="refsect1" title="Options">
<a id="idp44126656"></a>
<h2>Options</h2>
<div class="informalexample">
<pre class="screen">
--revision (-r) REV
--revprop
--transaction (-t) TXN
</pre>
</div>
</div>
<div class="refsect1" title="Examples">
<a id="idp44128560"></a>
<h2>Examples</h2>
<p>This shows the value of the <span class="quote">“<span class="quote">seasonings</span>”</span> property
on the file <code class="filename">/trunk/sandwich</code> in the
<code class="literal">HEAD</code> revision:</p>
<div class="informalexample">
<pre class="screen">
$ svnlook pg /var/svn/repos seasonings /trunk/sandwich
mustard
</pre>
</div>
</div>
</div>
<div class="navfooter">
<hr />
<table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left"><a accesskey="p" href="svn.ref.svnlook.c.log.html">Prev</a> </td>
<td width="20%" align="center">
<a accesskey="u" href="svn.ref.svnlook.html#svn.ref.svnlook.c">Up</a>
</td>
<td width="40%" align="right"> <a accesskey="n" href="svn.ref.svnlook.c.proplist.html">Next</a></td>
</tr>
<tr>
<td width="40%" align="left" valign="top">svnlook log </td>
<td width="20%" align="center">
<a accesskey="h" href="index.html">Home</a>
</td>
<td width="40%" align="right" valign="top"> svnlook proplist</td>
</tr>
</table>
</div>
<div xmlns="" id="svn-footer">
<hr />
<p>You are reading <em>Version Control with Subversion</em> (for Subversion 1.7), by Ben Collins-Sussman, Brian W. Fitzpatrick, and C. Michael Pilato.<br />
This work is licensed under the <a href="http://creativecommons.org/licenses/by/2.0/">Creative Commons Attribution License v2.0</a>.<br />
To submit comments, corrections, or other contributions to the text, please visit <a href="http://www.svnbook.com/">http://www.svnbook.com/</a>.</p>
</div>
</body>
</html>

113
pdf/NWS_Documentation/Subversion/1. 7 svn-book-html-chunk/SV0D1C~1.HTM Normal file
View file

@ -0,0 +1,113 @@
<?xml version="1.0" encoding="utf-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>svnadmin rmtxns</title>
<link rel="stylesheet" href="styles.css" type="text/css" />
<meta name="generator" content="DocBook XSL Stylesheets V1.75.2" />
<style type="text/css">
body { background-image: url('images/draft.png');
background-repeat: no-repeat;
background-position: top left;
/* The following properties make the watermark "fixed" on the page. */
/* I think that's just a bit too distracting for the reader... */
/* background-attachment: fixed; */
/* background-position: center center; */
}</style>
<link rel="home" href="index.html" title="Version Control with Subversion [DRAFT]" />
<link rel="up" href="svn.ref.svnadmin.html#svn.ref.svnadmin.c" title="svnadmin Subcommands" />
<link rel="prev" href="svn.ref.svnadmin.c.rmlocks.html" title="svnadmin rmlocks" />
<link rel="next" href="svn.ref.svnadmin.c.setlog.html" title="svnadmin setlog" />
</head>
<body>
<div class="navheader">
<table width="100%" summary="Navigation header">
<tr>
<th colspan="3" align="center">svnadmin rmtxns</th>
</tr>
<tr>
<td width="20%" align="left"><a accesskey="p" href="svn.ref.svnadmin.c.rmlocks.html">Prev</a> </td>
<th width="60%" align="center">svnadmin Subcommands</th>
<td width="20%" align="right"> <a accesskey="n" href="svn.ref.svnadmin.c.setlog.html">Next</a></td>
</tr>
</table>
<hr />
</div>
<div class="refentry" title="svnadmin rmtxns">
<a id="svn.ref.svnadmin.c.rmtxns"></a>
<div class="titlepage"></div>
<a id="idp43825024" class="indexterm"></a>
<div class="refnamediv">
<h2>Name</h2>
<p>svnadmin rmtxns — Delete transactions from a repository.</p>
</div>
<div class="refsect1" title="Synopsis">
<a id="idp43828112"></a>
<h2>Synopsis</h2>
<p>
<code class="literal">svnadmin rmtxns REPOS_PATH TXN_NAME...</code>
</p>
</div>
<div class="refsect1" title="Description">
<a id="idp43829744"></a>
<h2>Description</h2>
<p>Delete outstanding transactions from a repository.
This is covered in detail in <a class="xref" href="svn.reposadmin.maint.html#svn.reposadmin.maint.diskspace.deadtxns" title="Removing dead transactions">the section called “Removing dead transactions”</a>.</p>
</div>
<div class="refsect1" title="Options">
<a id="idp43831760"></a>
<h2>Options</h2>
<div class="informalexample">
<pre class="screen">
--quiet (-q)
</pre>
</div>
</div>
<div class="refsect1" title="Examples">
<a id="idp43833632"></a>
<h2>Examples</h2>
<p>Remove named transactions:</p>
<div class="informalexample">
<pre class="screen">
$ svnadmin rmtxns /var/svn/repos/ 1w 1x
</pre>
</div>
<p>Fortunately, the output of <span class="command"><strong>lstxns</strong></span>
works great as the input for <span class="command"><strong>rmtxns</strong></span>:</p>
<div class="informalexample">
<pre class="screen">
$ svnadmin rmtxns /var/svn/repos/ `svnadmin lstxns /var/svn/repos/`
</pre>
</div>
<p>This removes all uncommitted transactions from
your repository.</p>
</div>
</div>
<div class="navfooter">
<hr />
<table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left"><a accesskey="p" href="svn.ref.svnadmin.c.rmlocks.html">Prev</a> </td>
<td width="20%" align="center">
<a accesskey="u" href="svn.ref.svnadmin.html#svn.ref.svnadmin.c">Up</a>
</td>
<td width="40%" align="right"> <a accesskey="n" href="svn.ref.svnadmin.c.setlog.html">Next</a></td>
</tr>
<tr>
<td width="40%" align="left" valign="top">svnadmin rmlocks </td>
<td width="20%" align="center">
<a accesskey="h" href="index.html">Home</a>
</td>
<td width="40%" align="right" valign="top"> svnadmin setlog</td>
</tr>
</table>
</div>
<div xmlns="" id="svn-footer">
<hr />
<p>You are reading <em>Version Control with Subversion</em> (for Subversion 1.7), by Ben Collins-Sussman, Brian W. Fitzpatrick, and C. Michael Pilato.<br />
This work is licensed under the <a href="http://creativecommons.org/licenses/by/2.0/">Creative Commons Attribution License v2.0</a>.<br />
To submit comments, corrections, or other contributions to the text, please visit <a href="http://www.svnbook.com/">http://www.svnbook.com/</a>.</p>
</div>
</body>
</html>

131
pdf/NWS_Documentation/Subversion/1. 7 svn-book-html-chunk/SV0D49~1.HTM Normal file
View file

@ -0,0 +1,131 @@
<?xml version="1.0" encoding="utf-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>svnadmin setlog</title>
<link rel="stylesheet" href="styles.css" type="text/css" />
<meta name="generator" content="DocBook XSL Stylesheets V1.75.2" />
<style type="text/css">
body { background-image: url('images/draft.png');
background-repeat: no-repeat;
background-position: top left;
/* The following properties make the watermark "fixed" on the page. */
/* I think that's just a bit too distracting for the reader... */
/* background-attachment: fixed; */
/* background-position: center center; */
}</style>
<link rel="home" href="index.html" title="Version Control with Subversion [DRAFT]" />
<link rel="up" href="svn.ref.svnadmin.html#svn.ref.svnadmin.c" title="svnadmin Subcommands" />
<link rel="prev" href="svn.ref.svnadmin.c.rmtxns.html" title="svnadmin rmtxns" />
<link rel="next" href="svn.ref.svnadmin.c.setrevprop.html" title="svnadmin setrevprop" />
</head>
<body>
<div class="navheader">
<table width="100%" summary="Navigation header">
<tr>
<th colspan="3" align="center">svnadmin setlog</th>
</tr>
<tr>
<td width="20%" align="left"><a accesskey="p" href="svn.ref.svnadmin.c.rmtxns.html">Prev</a> </td>
<th width="60%" align="center">svnadmin Subcommands</th>
<td width="20%" align="right"> <a accesskey="n" href="svn.ref.svnadmin.c.setrevprop.html">Next</a></td>
</tr>
</table>
<hr />
</div>
<div class="refentry" title="svnadmin setlog">
<a id="svn.ref.svnadmin.c.setlog"></a>
<div class="titlepage"></div>
<a id="idp43840656" class="indexterm"></a>
<div class="refnamediv">
<h2>Name</h2>
<p>svnadmin setlog — Set the log message on a revision.</p>
</div>
<div class="refsect1" title="Synopsis">
<a id="idp43843744"></a>
<h2>Synopsis</h2>
<p>
<code class="literal">svnadmin setlog REPOS_PATH -r REVISION FILE</code>
</p>
</div>
<div class="refsect1" title="Description">
<a id="idp43845392"></a>
<h2>Description</h2>
<p>Set the log message on
revision <em class="replaceable"><code>REVISION</code></em> to the
contents of <em class="replaceable"><code>FILE</code></em>.</p>
<p>This is similar to using <span class="command"><strong>svn propset</strong></span>
with the <code class="option">--revprop</code> option to set the <code class="literal">svn:log</code> property
on a revision, except that you can also use the option
<code class="option">--bypass-hooks</code> to avoid running any pre-
or post-commit hooks, which is useful if the modification
of revision properties has not been enabled in
the <code class="literal">pre-revprop-change</code> hook.</p>
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<table border="0" summary="Warning">
<tr>
<td rowspan="2" align="center" valign="top" width="25">
<img alt="[Warning]" src="images/warning.png" />
</td>
<th align="left">Warning</th>
</tr>
<tr>
<td align="left" valign="top">
<p>Revision properties are not under version control,
so this command will permanently overwrite the previous
log message.</p>
</td>
</tr>
</table>
</div>
</div>
<div class="refsect1" title="Options">
<a id="idp43852176"></a>
<h2>Options</h2>
<div class="informalexample">
<pre class="screen">
--bypass-hooks
--revision (-r) REV
</pre>
</div>
</div>
<div class="refsect1" title="Examples">
<a id="idp43854064"></a>
<h2>Examples</h2>
<p>Set the log message for revision 19 to the contents of
the file <code class="filename">msg</code>:</p>
<div class="informalexample">
<pre class="screen">
$ svnadmin setlog /var/svn/repos/ -r 19 msg
</pre>
</div>
</div>
</div>
<div class="navfooter">
<hr />
<table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left"><a accesskey="p" href="svn.ref.svnadmin.c.rmtxns.html">Prev</a> </td>
<td width="20%" align="center">
<a accesskey="u" href="svn.ref.svnadmin.html#svn.ref.svnadmin.c">Up</a>
</td>
<td width="40%" align="right"> <a accesskey="n" href="svn.ref.svnadmin.c.setrevprop.html">Next</a></td>
</tr>
<tr>
<td width="40%" align="left" valign="top">svnadmin rmtxns </td>
<td width="20%" align="center">
<a accesskey="h" href="index.html">Home</a>
</td>
<td width="40%" align="right" valign="top"> svnadmin setrevprop</td>
</tr>
</table>
</div>
<div xmlns="" id="svn-footer">
<hr />
<p>You are reading <em>Version Control with Subversion</em> (for Subversion 1.7), by Ben Collins-Sussman, Brian W. Fitzpatrick, and C. Michael Pilato.<br />
This work is licensed under the <a href="http://creativecommons.org/licenses/by/2.0/">Creative Commons Attribution License v2.0</a>.<br />
To submit comments, corrections, or other contributions to the text, please visit <a href="http://www.svnbook.com/">http://www.svnbook.com/</a>.</p>
</div>
</body>
</html>

213
pdf/NWS_Documentation/Subversion/1. 7 svn-book-html-chunk/SV189E~1.HTM Normal file
View file

@ -0,0 +1,213 @@
<?xml version="1.0" encoding="utf-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Overview</title>
<link rel="stylesheet" href="styles.css" type="text/css" />
<meta name="generator" content="DocBook XSL Stylesheets V1.75.2" />
<style type="text/css">
body { background-image: url('images/draft.png');
background-repeat: no-repeat;
background-position: top left;
/* The following properties make the watermark "fixed" on the page. */
/* I think that's just a bit too distracting for the reader... */
/* background-attachment: fixed; */
/* background-position: center center; */
}</style>
<link rel="home" href="index.html" title="Version Control with Subversion [DRAFT]" />
<link rel="up" href="svn.serverconfig.html" title="Chapter 6. Server Configuration" />
<link rel="prev" href="svn.serverconfig.html" title="Chapter 6. Server Configuration" />
<link rel="next" href="svn.serverconfig.choosing.html" title="Choosing a Server Configuration" />
</head>
<body>
<div class="navheader">
<table width="100%" summary="Navigation header">
<tr>
<th colspan="3" align="center">Overview</th>
</tr>
<tr>
<td width="20%" align="left"><a accesskey="p" href="svn.serverconfig.html">Prev</a> </td>
<th width="60%" align="center">Chapter 6. Server Configuration</th>
<td width="20%" align="right"> <a accesskey="n" href="svn.serverconfig.choosing.html">Next</a></td>
</tr>
</table>
<hr />
</div>
<div class="sect1" title="Overview">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a id="svn.serverconfig.overview"></a>Overview</h2>
</div>
</div>
</div>
<p>Subversion was designed with an abstract repository access layer.
This means that a repository can be programmatically accessed by
any sort of server process, and the client <span class="quote">“<span class="quote">repository
access</span>”</span> API allows programmers to write plug-ins that
speak relevant network protocols. In theory, Subversion can use
an infinite number of network implementations. In practice,
there are only two Subversion servers in widespread use today.</p>
<p>Apache is an extremely popular web server; using the
<span class="command"><strong>mod_dav_svn</strong></span> module, Apache can access a
repository and make it available to clients via the
WebDAV/DeltaV protocol, which is an extension of HTTP. Because
Apache is an extremely extensible server, it provides a number
of features <span class="quote">“<span class="quote">for free,</span>”</span> such as encrypted SSL
communication, logging, integration with a number of third-party
authentication systems, and limited built-in web browsing of
repositories.</p>
<p>In the other corner is <span class="command"><strong>svnserve</strong></span>: a small,
lightweight server program that speaks a custom protocol with
clients. Because its protocol is explicitly designed for
Subversion and is stateful (unlike HTTP), it provides
significantly faster network operations—but at the cost of
some features as well. While it can use SASL to provide a
variety of authentication and encryption options, it has no
logging or built-in web browsing. It is, however, extremely
easy to set up and is often the best option for small teams just
starting out with Subversion.</p>
<p>The network protocol which <span class="command"><strong>svnserve</strong></span>
speaks may also be tunneled over an SSH connection. This
deployment option for <span class="command"><strong>svnserve</strong></span> differs quite
a bit in features from a traditional <span class="command"><strong>svnserve</strong></span>
deployment. SSH is used to encrypt all communication. SSH is
also used exclusively to authenticate, so real system accounts
are required on the server host (unlike
vanilla <span class="command"><strong>svnserve</strong></span>, which has its own private
user accounts). Finally, because this setup requires that each
user spawn a private, temporary <span class="command"><strong>svnserve</strong></span>
process, it's equivalent (from a permissions point of view) to
allowing a group of local users to all access the repository
via <code class="literal">file://</code> URLs. Path-based access control
has no meaning, since each user is accessing the repository
database files directly.</p>
<p><a class="xref" href="svn.serverconfig.overview.html#svn.serverconfig.overview.tbl-1" title="Table 6.1. Comparison of subversion server options">Table 6.1, “Comparison of subversion server options”</a> provides a
quick summary of the three typical server deployments.</p>
<div class="table">
<a id="svn.serverconfig.overview.tbl-1"></a>
<p class="title">
<b>Table 6.1. Comparison of subversion server options</b>
</p>
<div class="table-contents">
<table summary="Comparison of subversion server options" border="1">
<colgroup>
<col />
<col />
<col />
<col />
</colgroup>
<thead>
<tr>
<th>Feature</th>
<th>Apache + mod_dav_svn</th>
<th>svnserve</th>
<th>svnserve over SSH</th>
</tr>
</thead>
<tbody>
<tr>
<td>Authentication options</td>
<td>HTTP Basic or Digest auth, X.509 certificates, LDAP,
NTLM, or any other mechanism available to Apache httpd</td>
<td>CRAM-MD5 by default; LDAP, NTLM, or any other mechanism
available to SASL</td>
<td>SSH</td>
</tr>
<tr>
<td>User account options</td>
<td>Private <span class="quote">“<span class="quote">users</span>”</span> file, or other mechanisms
available to Apache httpd (LDAP, SQL, etc.)</td>
<td>Private <span class="quote">“<span class="quote">users</span>”</span> file, or other
mechanisms available to SASL (LDAP, SQL, etc.)</td>
<td>System accounts</td>
</tr>
<tr>
<td>Authorization options</td>
<td>Read/write access can be granted over the whole
repository, or specified per path</td>
<td>Read/write access can be granted over the whole
repository, or specified per path</td>
<td>Read/write access only grantable over the whole
repository</td>
</tr>
<tr>
<td>Encryption</td>
<td>Available via optional SSL (https)</td>
<td>Available via optional SASL features</td>
<td>Inherent in SSH connection</td>
</tr>
<tr>
<td>Logging</td>
<td>High-level operational logging of Subversion
operations plus detailed logging at the
per-HTTP-request level</td>
<td>High-level operational logging only</td>
<td>High-level operational logging only</td>
</tr>
<tr>
<td>Interoperability</td>
<td>Accessible by other WebDAV clients</td>
<td>Talks only to svn clients</td>
<td>Talks only to svn clients</td>
</tr>
<tr>
<td>Web viewing</td>
<td>Limited built-in support, or via third-party tools
such as ViewVC</td>
<td>Only via third-party tools such as ViewVC</td>
<td>Only via third-party tools such as ViewVC</td>
</tr>
<tr>
<td>Master-slave server replication</td>
<td>Transparent write-proxying available from slave to
master</td>
<td>Can only create read-only slave servers</td>
<td>Can only create read-only slave servers</td>
</tr>
<tr>
<td>Speed</td>
<td>Somewhat slower</td>
<td>Somewhat faster</td>
<td>Somewhat faster</td>
</tr>
<tr>
<td>Initial setup</td>
<td>Somewhat complex</td>
<td>Extremely simple</td>
<td>Moderately simple</td>
</tr>
</tbody>
</table>
</div>
</div>
<br class="table-break" />
</div>
<div class="navfooter">
<hr />
<table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left"><a accesskey="p" href="svn.serverconfig.html">Prev</a> </td>
<td width="20%" align="center">
<a accesskey="u" href="svn.serverconfig.html">Up</a>
</td>
<td width="40%" align="right"> <a accesskey="n" href="svn.serverconfig.choosing.html">Next</a></td>
</tr>
<tr>
<td width="40%" align="left" valign="top">Chapter 6. Server Configuration </td>
<td width="20%" align="center">
<a accesskey="h" href="index.html">Home</a>
</td>
<td width="40%" align="right" valign="top"> Choosing a Server Configuration</td>
</tr>
</table>
</div>
<div xmlns="" id="svn-footer">
<hr />
<p>You are reading <em>Version Control with Subversion</em> (for Subversion 1.7), by Ben Collins-Sussman, Brian W. Fitzpatrick, and C. Michael Pilato.<br />
This work is licensed under the <a href="http://creativecommons.org/licenses/by/2.0/">Creative Commons Attribution License v2.0</a>.<br />
To submit comments, corrections, or other contributions to the text, please visit <a href="http://www.svnbook.com/">http://www.svnbook.com/</a>.</p>
</div>
</body>
</html>

363
pdf/NWS_Documentation/Subversion/1. 7 svn-book-html-chunk/SV1994~1.HTM Normal file
View file

@ -0,0 +1,363 @@
<?xml version="1.0" encoding="utf-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Revision Specifiers</title>
<link rel="stylesheet" href="styles.css" type="text/css" />
<meta name="generator" content="DocBook XSL Stylesheets V1.75.2" />
<style type="text/css">
body { background-image: url('images/draft.png');
background-repeat: no-repeat;
background-position: top left;
/* The following properties make the watermark "fixed" on the page. */
/* I think that's just a bit too distracting for the reader... */
/* background-attachment: fixed; */
/* background-position: center center; */
}</style>
<link rel="home" href="index.html" title="Version Control with Subversion [DRAFT]" />
<link rel="up" href="svn.advanced.html" title="Chapter 3. Advanced Topics" />
<link rel="prev" href="svn.advanced.html" title="Chapter 3. Advanced Topics" />
<link rel="next" href="svn.advanced.pegrevs.html" title="Peg and Operative Revisions" />
</head>
<body>
<div class="navheader">
<table width="100%" summary="Navigation header">
<tr>
<th colspan="3" align="center">Revision Specifiers</th>
</tr>
<tr>
<td width="20%" align="left"><a accesskey="p" href="svn.advanced.html">Prev</a> </td>
<th width="60%" align="center">Chapter 3. Advanced Topics</th>
<td width="20%" align="right"> <a accesskey="n" href="svn.advanced.pegrevs.html">Next</a></td>
</tr>
</table>
<hr />
</div>
<div class="sect1" title="Revision Specifiers">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a id="svn.tour.revs.specifiers"></a>Revision Specifiers</h2>
</div>
</div>
</div>
<p>As we described in <a class="xref" href="svn.basic.in-action.html#svn.basic.in-action.revs" title="Revisions">the section called “Revisions”</a>, revision numbers in Subversion are pretty
straightforward—integers that keep getting larger as you
commit more changes to your versioned data. Still, it doesn't
take long before you can no longer remember exactly what
happened in each and every revision. Fortunately, the typical
Subversion workflow doesn't often demand that you supply
arbitrary revisions to the Subversion operations you perform.
For operations that <span class="emphasis"><em>do</em></span> require a revision
specifier, you generally supply a revision number that you saw
in a commit email, in the output of some other Subversion
operation, or in some other context that would give meaning to
that particular number.</p>
<div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;">
<table border="0" summary="Note">
<tr>
<td rowspan="2" align="center" valign="top" width="25">
<img alt="[Note]" src="images/note.png" />
</td>
<th align="left">Note</th>
</tr>
<tr>
<td align="left" valign="top">
<p>Referring to revision numbers with
an <span class="quote">“<span class="quote"><code class="literal">r</code></span>”</span> prefix
(<code class="literal">r314</code>, for example) is an established
practice in Subversion communities, and is both supported and
encouraged by many Subversion-related tools. In most places
where you would specify a bare revision number on the command
line, you may also use
the <code class="literal">r</code><em class="replaceable"><code>NNN</code></em>
syntax.</p>
</td>
</tr>
</table>
</div>
<p>But occasionally, you need to pinpoint a moment in time for
which you don't already have a revision number memorized or
handy. So besides the integer revision numbers,
<span class="command"><strong>svn</strong></span> allows as input some additional forms of
revision specifiers: <em class="firstterm">revision keywords</em>
and revision dates.</p>
<div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;">
<table border="0" summary="Note">
<tr>
<td rowspan="2" align="center" valign="top" width="25">
<img alt="[Note]" src="images/note.png" />
</td>
<th align="left">Note</th>
</tr>
<tr>
<td align="left" valign="top">
<p>The various forms of Subversion revision specifiers can be
mixed and matched when used to specify revision ranges. For
example, you can use <code class="option">-r
<em class="replaceable"><code>REV1</code></em>:<em class="replaceable"><code>REV2</code></em></code>
where <em class="replaceable"><code>REV1</code></em> is a revision keyword
and <em class="replaceable"><code>REV2</code></em> is a revision number, or
where <em class="replaceable"><code>REV1</code></em> is a date and
<em class="replaceable"><code>REV2</code></em> is a revision keyword, and so
on. The individual revision specifiers are independently
evaluated, so you can put whatever you want on the opposite
sides of that colon.</p>
</td>
</tr>
</table>
</div>
<div class="sect2" title="Revision Keywords">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a id="svn.tour.revs.keywords"></a>Revision Keywords</h3>
</div>
</div>
</div>
<a id="idp33928160" class="indexterm"></a>
<p>The Subversion client understands a number of revision
keywords. These keywords can be used instead of integer
arguments to the <code class="option">--revision</code>
(<code class="option">-r</code>) option, and are resolved into specific
revision numbers by Subversion:</p>
<div class="variablelist">
<dl>
<dt>
<span class="term">
<code class="literal">HEAD</code>
</span>
</dt>
<dd>
<a id="idp33932752" class="indexterm"></a>
<a id="idp33933824" class="indexterm"></a>
<p>The latest (or <span class="quote">“<span class="quote">youngest</span>”</span>) revision in
the repository.</p>
</dd>
<dt>
<span class="term">
<code class="literal">BASE</code>
</span>
</dt>
<dd>
<a id="idp33938208" class="indexterm"></a>
<a id="idp33939280" class="indexterm"></a>
<p>The revision number of an item in a working copy.
If the item has been locally modified, this refers to
the way the item appears without those local
modifications.</p>
</dd>
<dt>
<span class="term">
<code class="literal">COMMITTED</code>
</span>
</dt>
<dd>
<a id="idp33943376" class="indexterm"></a>
<a id="idp33944448" class="indexterm"></a>
<p>The most recent revision prior to, or equal to,
<code class="literal">BASE</code>, in which an item changed.</p>
</dd>
<dt>
<span class="term">
<code class="literal">PREV</code>
</span>
</dt>
<dd>
<a id="idp33949056" class="indexterm"></a>
<a id="idp33950128" class="indexterm"></a>
<p>The revision immediately <span class="emphasis"><em>before</em></span>
the last revision in which an item changed.
Technically, this boils down to
<code class="literal">COMMITTED</code>-1.</p>
</dd>
</dl>
</div>
<p>As can be derived from their descriptions, the
<code class="literal">PREV</code>, <code class="literal">BASE</code>, and
<code class="literal">COMMITTED</code> revision keywords are used only
when referring to a working copy path—they don't apply
to repository URLs. <code class="literal">HEAD</code>, on the other
hand, can be used in conjunction with both of these path
types.</p>
<p>Here are some examples of revision keywords in
action:</p>
<div class="informalexample">
<pre class="screen">
$ svn diff -r PREV:COMMITTED foo.c
# shows the last change committed to foo.c
$ svn log -r HEAD
# shows log message for the latest repository commit
$ svn diff -r HEAD
# compares your working copy (with all of its local changes) to the
# latest version of that tree in the repository
$ svn diff -r BASE:HEAD foo.c
# compares the unmodified version of foo.c with the latest version of
# foo.c in the repository
$ svn log -r BASE:HEAD
# shows all commit logs for the current versioned directory since you
# last updated
$ svn update -r PREV foo.c
# rewinds the last change on foo.c, decreasing foo.c's working revision
$ svn diff -r BASE:14 foo.c
# compares the unmodified version of foo.c with the way foo.c looked
# in revision 14
</pre>
</div>
</div>
<div class="sect2" title="Revision Dates">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a id="svn.tour.revs.dates"></a>Revision Dates</h3>
</div>
</div>
</div>
<a id="idp33961536" class="indexterm"></a>
<p>Revision numbers reveal nothing about the world outside
the version control system, but sometimes you need to
correlate a moment in real time with a moment in version
history. To facilitate this, the <code class="option">--revision</code>
(<code class="option">-r</code>) option can also accept as input date
specifiers wrapped in curly braces (<code class="literal">{</code> and
<code class="literal">}</code>). Subversion accepts the standard
ISO-8601 date and time formats, plus a few others. Here are
some examples.</p>
<div class="informalexample">
<pre class="screen">
$ svn checkout -r {2006-02-17}
$ svn checkout -r {15:30}
$ svn checkout -r {15:30:00.200000}
$ svn checkout -r {"2006-02-17 15:30"}
$ svn checkout -r {"2006-02-17 15:30 +0230"}
$ svn checkout -r {2006-02-17T15:30}
$ svn checkout -r {2006-02-17T15:30Z}
$ svn checkout -r {2006-02-17T15:30-04:00}
$ svn checkout -r {20060217T1530}
$ svn checkout -r {20060217T1530Z}
$ svn checkout -r {20060217T1530-0500}
…
</pre>
</div>
<div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;">
<table border="0" summary="Note">
<tr>
<td rowspan="2" align="center" valign="top" width="25">
<img alt="[Note]" src="images/note.png" />
</td>
<th align="left">Note</th>
</tr>
<tr>
<td align="left" valign="top">
<p>Keep in mind that most shells will require you to, at a
minimum, quote or otherwise escape any spaces that are
included as part of revision date specifiers. Certain
shells may also take issue with the unescaped use of curly
brances, too. Consult your shell's documentation for the
requirements specific to your environment.</p>
</td>
</tr>
</table>
</div>
<p>When you specify a date, Subversion resolves that date to
the most recent revision of the repository as of that date,
and then continues to operate against that resolved revision
number:</p>
<div class="informalexample">
<pre class="screen">
$ svn log -r {2006-11-28}
------------------------------------------------------------------------
r12 | ira | 2006-11-27 12:31:51 -0600 (Mon, 27 Nov 2006) | 6 lines
…
</pre>
</div>
<div class="sidebar" title="Is Subversion a Day Early?">
<p class="title">
<b>Is Subversion a Day Early?</b>
</p>
<p>If you specify a single date as a revision without
specifying a time of day (for example
<code class="literal">2006-11-27</code>), you may think that Subversion
should give you the last revision that took place on the
27th of November. Instead, you'll get back a revision from
the 26th, or even earlier. Remember that Subversion will
find the <span class="emphasis"><em>most recent revision of the
repository</em></span> as of the date you give. If you give
a date without a timestamp, such as
<code class="literal">2006-11-27</code>, Subversion assumes a time of
00:00:00, so looking for the most recent revision won't
return anything on the 27th.</p>
<p>If you want to include the 27th in your search, you can
either specify the 27th with the time (<code class="literal">{"2006-11-27
23:59"}</code>), or just specify the next day
(<code class="literal">{2006-11-28}</code>).</p>
</div>
<p>You can also use a range of dates. Subversion will find
all revisions between both dates, inclusive:</p>
<div class="informalexample">
<pre class="screen">
$ svn log -r {2006-11-20}:{2006-11-29}
…
</pre>
</div>
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<table border="0" summary="Warning">
<tr>
<td rowspan="2" align="center" valign="top" width="25">
<img alt="[Warning]" src="images/warning.png" />
</td>
<th align="left">Warning</th>
</tr>
<tr>
<td align="left" valign="top">
<p>Since the timestamp of a revision is stored as an
unversioned, modifiable property of the revision (see <a class="xref" href="svn.advanced.props.html" title="Properties">the section called “Properties”</a>), revision timestamps can be
changed to represent complete falsifications of true
chronology, or even removed altogether. Subversion's
ability to correctly convert revision dates into real
revision numbers depends on revision datestamps maintaining
a sequential ordering—the younger the revision, the
younger its timestamp. If this ordering isn't maintained,
you will likely find that trying to use dates to specify
revision ranges in your repository doesn't always return the
data you might have expected.</p>
</td>
</tr>
</table>
</div>
</div>
</div>
<div class="navfooter">
<hr />
<table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left"><a accesskey="p" href="svn.advanced.html">Prev</a> </td>
<td width="20%" align="center">
<a accesskey="u" href="svn.advanced.html">Up</a>
</td>
<td width="40%" align="right"> <a accesskey="n" href="svn.advanced.pegrevs.html">Next</a></td>
</tr>
<tr>
<td width="40%" align="left" valign="top">Chapter 3. Advanced Topics </td>
<td width="20%" align="center">
<a accesskey="h" href="index.html">Home</a>
</td>
<td width="40%" align="right" valign="top"> Peg and Operative Revisions</td>
</tr>
</table>
</div>
<div xmlns="" id="svn-footer">
<hr />
<p>You are reading <em>Version Control with Subversion</em> (for Subversion 1.7), by Ben Collins-Sussman, Brian W. Fitzpatrick, and C. Michael Pilato.<br />
This work is licensed under the <a href="http://creativecommons.org/licenses/by/2.0/">Creative Commons Attribution License v2.0</a>.<br />
To submit comments, corrections, or other contributions to the text, please visit <a href="http://www.svnbook.com/">http://www.svnbook.com/</a>.</p>
</div>
</body>
</html>

108
pdf/NWS_Documentation/Subversion/1. 7 svn-book-html-chunk/SV2148~1.HTM Normal file
View file

@ -0,0 +1,108 @@
<?xml version="1.0" encoding="utf-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>svnlook dirs-changed</title>
<link rel="stylesheet" href="styles.css" type="text/css" />
<meta name="generator" content="DocBook XSL Stylesheets V1.75.2" />
<style type="text/css">
body { background-image: url('images/draft.png');
background-repeat: no-repeat;
background-position: top left;
/* The following properties make the watermark "fixed" on the page. */
/* I think that's just a bit too distracting for the reader... */
/* background-attachment: fixed; */
/* background-position: center center; */
}</style>
<link rel="home" href="index.html" title="Version Control with Subversion [DRAFT]" />
<link rel="up" href="svn.ref.svnlook.html#svn.ref.svnlook.c" title="svnlook Subcommands" />
<link rel="prev" href="svn.ref.svnlook.c.diff.html" title="svnlook diff" />
<link rel="next" href="svn.ref.svnlook.c.filesize.html" title="svnlook filesize" />
</head>
<body>
<div class="navheader">
<table width="100%" summary="Navigation header">
<tr>
<th colspan="3" align="center">svnlook dirs-changed</th>
</tr>
<tr>
<td width="20%" align="left"><a accesskey="p" href="svn.ref.svnlook.c.diff.html">Prev</a> </td>
<th width="60%" align="center">svnlook Subcommands</th>
<td width="20%" align="right"> <a accesskey="n" href="svn.ref.svnlook.c.filesize.html">Next</a></td>
</tr>
</table>
<hr />
</div>
<div class="refentry" title="svnlook dirs-changed">
<a id="svn.ref.svnlook.c.dirs-changed"></a>
<div class="titlepage"></div>
<a id="idp44033040" class="indexterm"></a>
<div class="refnamediv">
<h2>Name</h2>
<p>svnlook dirs-changed — Print the directories that were themselves changed.</p>
</div>
<div class="refsect1" title="Synopsis">
<a id="idp44036192"></a>
<h2>Synopsis</h2>
<p>
<code class="literal">svnlook dirs-changed REPOS_PATH</code>
</p>
</div>
<div class="refsect1" title="Description">
<a id="idp44037776"></a>
<h2>Description</h2>
<p>Print the directories that were themselves changed
(property edits) or whose file children were
changed.</p>
</div>
<div class="refsect1" title="Options">
<a id="idp44039104"></a>
<h2>Options</h2>
<div class="informalexample">
<pre class="screen">
--revision (-r) REV
--transaction (-t) TXN
</pre>
</div>
</div>
<div class="refsect1" title="Examples">
<a id="idp44041008"></a>
<h2>Examples</h2>
<p>This shows the directories that changed in
revision 40 in our sample repository:</p>
<div class="informalexample">
<pre class="screen">
$ svnlook dirs-changed -r 40 /var/svn/repos
trunk/vendors/deli/
</pre>
</div>
</div>
</div>
<div class="navfooter">
<hr />
<table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left"><a accesskey="p" href="svn.ref.svnlook.c.diff.html">Prev</a> </td>
<td width="20%" align="center">
<a accesskey="u" href="svn.ref.svnlook.html#svn.ref.svnlook.c">Up</a>
</td>
<td width="40%" align="right"> <a accesskey="n" href="svn.ref.svnlook.c.filesize.html">Next</a></td>
</tr>
<tr>
<td width="40%" align="left" valign="top">svnlook diff </td>
<td width="20%" align="center">
<a accesskey="h" href="index.html">Home</a>
</td>
<td width="40%" align="right" valign="top"> svnlook filesize</td>
</tr>
</table>
</div>
<div xmlns="" id="svn-footer">
<hr />
<p>You are reading <em>Version Control with Subversion</em> (for Subversion 1.7), by Ben Collins-Sussman, Brian W. Fitzpatrick, and C. Michael Pilato.<br />
This work is licensed under the <a href="http://creativecommons.org/licenses/by/2.0/">Creative Commons Attribution License v2.0</a>.<br />
To submit comments, corrections, or other contributions to the text, please visit <a href="http://www.svnbook.com/">http://www.svnbook.com/</a>.</p>
</div>
</body>
</html>

123
pdf/NWS_Documentation/Subversion/1. 7 svn-book-html-chunk/SV22AD~1.HTM Normal file
View file

@ -0,0 +1,123 @@
<?xml version="1.0" encoding="utf-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>pre-revprop-change</title>
<link rel="stylesheet" href="styles.css" type="text/css" />
<meta name="generator" content="DocBook XSL Stylesheets V1.75.2" />
<style type="text/css">
body { background-image: url('images/draft.png');
background-repeat: no-repeat;
background-position: top left;
/* The following properties make the watermark "fixed" on the page. */
/* I think that's just a bit too distracting for the reader... */
/* background-attachment: fixed; */
/* background-position: center center; */
}</style>
<link rel="home" href="index.html" title="Version Control with Subversion [DRAFT]" />
<link rel="up" href="svn.ref.reposhooks.html" title="Repository Hooks" />
<link rel="prev" href="svn.ref.reposhooks.post-commit.html" title="post-commit" />
<link rel="next" href="svn.ref.reposhooks.post-revprop-change.html" title="post-revprop-change" />
</head>
<body>
<div class="navheader">
<table width="100%" summary="Navigation header">
<tr>
<th colspan="3" align="center">pre-revprop-change</th>
</tr>
<tr>
<td width="20%" align="left"><a accesskey="p" href="svn.ref.reposhooks.post-commit.html">Prev</a> </td>
<th width="60%" align="center">Repository Hooks</th>
<td width="20%" align="right"> <a accesskey="n" href="svn.ref.reposhooks.post-revprop-change.html">Next</a></td>
</tr>
</table>
<hr />
</div>
<div class="refentry" title="pre-revprop-change">
<a id="svn.ref.reposhooks.pre-revprop-change"></a>
<div class="titlepage"></div>
<a id="idp44867312" class="indexterm"></a>
<div class="refnamediv">
<h2>Name</h2>
<p>pre-revprop-change — Notification of a revision property change
attempt.</p>
</div>
<div class="refsect1" title="Description">
<a id="idp44870400"></a>
<h2>Description</h2>
<p>The <code class="literal">pre-revprop-change</code> hook is run
immediately prior to the modification of a revision property
when performed outside the scope of a normal commit. Unlike
the other hooks, the default state of this one is to deny
the proposed action. The hook must actually exist and
return a zero exit value before a revision property
modification can happen.</p>
<p>If the <code class="literal">pre-revprop-change</code> hook
doesn't exist, isn't executable, or returns a nonzero exit
value, no change to the property will be made, and anything
printed to <code class="filename">stderr</code> is marshalled back to the client.</p>
</div>
<div class="refsect1" title="Input parameter(s)">
<a id="idp44874672"></a>
<h2>Input parameter(s)</h2>
<p>The command-line arguments passed to the hook program,
in order, are:</p>
<div class="orderedlist">
<ol class="orderedlist" type="1">
<li class="listitem">
<p>Repository path</p>
</li>
<li class="listitem">
<p>Revision whose property is about to be modified</p>
</li>
<li class="listitem">
<p>Authenticated username attempting the property change</p>
</li>
<li class="listitem">
<p>Name of the property changed</p>
</li>
<li class="listitem">
<p>Change description: <code class="literal">A</code> (added),
<code class="literal">D</code> (deleted), or <code class="literal">M</code>
(modified)</p>
</li>
</ol>
</div>
<p>Additionally, Subversion passes the intended new value
of the property to the hook program via standard
input.</p>
</div>
<div class="refsect1" title="Common uses">
<a id="idp44883584"></a>
<h2>Common uses</h2>
<p>Access control; change validation and control</p>
</div>
</div>
<div class="navfooter">
<hr />
<table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left"><a accesskey="p" href="svn.ref.reposhooks.post-commit.html">Prev</a> </td>
<td width="20%" align="center">
<a accesskey="u" href="svn.ref.reposhooks.html">Up</a>
</td>
<td width="40%" align="right"> <a accesskey="n" href="svn.ref.reposhooks.post-revprop-change.html">Next</a></td>
</tr>
<tr>
<td width="40%" align="left" valign="top">post-commit </td>
<td width="20%" align="center">
<a accesskey="h" href="index.html">Home</a>
</td>
<td width="40%" align="right" valign="top"> post-revprop-change</td>
</tr>
</table>
</div>
<div xmlns="" id="svn-footer">
<hr />
<p>You are reading <em>Version Control with Subversion</em> (for Subversion 1.7), by Ben Collins-Sussman, Brian W. Fitzpatrick, and C. Michael Pilato.<br />
This work is licensed under the <a href="http://creativecommons.org/licenses/by/2.0/">Creative Commons Attribution License v2.0</a>.<br />
To submit comments, corrections, or other contributions to the text, please visit <a href="http://www.svnbook.com/">http://www.svnbook.com/</a>.</p>
</div>
</body>
</html>

1195
pdf/NWS_Documentation/Subversion/1. 7 svn-book-html-chunk/SV23EF~1.HTM Normal file
View file

File diff suppressed because it is too large Load diff

125
pdf/NWS_Documentation/Subversion/1. 7 svn-book-html-chunk/SV2C3D~1.HTM Normal file
View file

@ -0,0 +1,125 @@
<?xml version="1.0" encoding="utf-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>svnlook history</title>
<link rel="stylesheet" href="styles.css" type="text/css" />
<meta name="generator" content="DocBook XSL Stylesheets V1.75.2" />
<style type="text/css">
body { background-image: url('images/draft.png');
background-repeat: no-repeat;
background-position: top left;
/* The following properties make the watermark "fixed" on the page. */
/* I think that's just a bit too distracting for the reader... */
/* background-attachment: fixed; */
/* background-position: center center; */
}</style>
<link rel="home" href="index.html" title="Version Control with Subversion [DRAFT]" />
<link rel="up" href="svn.ref.svnlook.html#svn.ref.svnlook.c" title="svnlook Subcommands" />
<link rel="prev" href="svn.ref.svnlook.c.help.html" title="svnlook help" />
<link rel="next" href="svn.ref.svnlook.c.info.html" title="svnlook info" />
</head>
<body>
<div class="navheader">
<table width="100%" summary="Navigation header">
<tr>
<th colspan="3" align="center">svnlook history</th>
</tr>
<tr>
<td width="20%" align="left"><a accesskey="p" href="svn.ref.svnlook.c.help.html">Prev</a> </td>
<th width="60%" align="center">svnlook Subcommands</th>
<td width="20%" align="right"> <a accesskey="n" href="svn.ref.svnlook.c.info.html">Next</a></td>
</tr>
</table>
<hr />
</div>
<div class="refentry" title="svnlook history">
<a id="svn.ref.svnlook.c.history"></a>
<div class="titlepage"></div>
<a id="idp44070720" class="indexterm"></a>
<div class="refnamediv">
<h2>Name</h2>
<p>svnlook history — Print information about the history of a path in
the repository (or the root directory if no path is
supplied).</p>
</div>
<div class="refsect1" title="Synopsis">
<a id="idp44073952"></a>
<h2>Synopsis</h2>
<p>
<code class="literal">svnlook history REPOS_PATH [PATH_IN_REPOS]</code>
</p>
</div>
<div class="refsect1" title="Description">
<a id="idp44075600"></a>
<h2>Description</h2>
<p>Print information about the history of a path in
the repository (or the root directory if no path is
supplied).</p>
</div>
<div class="refsect1" title="Options">
<a id="idp44076928"></a>
<h2>Options</h2>
<div class="informalexample">
<pre class="screen">
--limit (-l) NUM
--revision (-r) REV
--show-ids
</pre>
</div>
</div>
<div class="refsect1" title="Examples">
<a id="idp44078832"></a>
<h2>Examples</h2>
<p>This shows the history output for the path
<code class="filename">/branches/bookstore</code> as of revision 13 in our
sample repository:</p>
<div class="informalexample">
<pre class="screen">
$ svnlook history -r 13 /var/svn/repos /branches/bookstore --show-ids
REVISION PATH &lt;ID&gt;
-------- ---------
13 /branches/bookstore &lt;1.1.r13/390&gt;
12 /branches/bookstore &lt;1.1.r12/413&gt;
11 /branches/bookstore &lt;1.1.r11/0&gt;
9 /trunk &lt;1.0.r9/551&gt;
8 /trunk &lt;1.0.r8/131357096&gt;
7 /trunk &lt;1.0.r7/294&gt;
6 /trunk &lt;1.0.r6/353&gt;
5 /trunk &lt;1.0.r5/349&gt;
4 /trunk &lt;1.0.r4/332&gt;
3 /trunk &lt;1.0.r3/335&gt;
2 /trunk &lt;1.0.r2/295&gt;
1 /trunk &lt;1.0.r1/532&gt;
</pre>
</div>
</div>
</div>
<div class="navfooter">
<hr />
<table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left"><a accesskey="p" href="svn.ref.svnlook.c.help.html">Prev</a> </td>
<td width="20%" align="center">
<a accesskey="u" href="svn.ref.svnlook.html#svn.ref.svnlook.c">Up</a>
</td>
<td width="40%" align="right"> <a accesskey="n" href="svn.ref.svnlook.c.info.html">Next</a></td>
</tr>
<tr>
<td width="40%" align="left" valign="top">svnlook help </td>
<td width="20%" align="center">
<a accesskey="h" href="index.html">Home</a>
</td>
<td width="40%" align="right" valign="top"> svnlook info</td>
</tr>
</table>
</div>
<div xmlns="" id="svn-footer">
<hr />
<p>You are reading <em>Version Control with Subversion</em> (for Subversion 1.7), by Ben Collins-Sussman, Brian W. Fitzpatrick, and C. Michael Pilato.<br />
This work is licensed under the <a href="http://creativecommons.org/licenses/by/2.0/">Creative Commons Attribution License v2.0</a>.<br />
To submit comments, corrections, or other contributions to the text, please visit <a href="http://www.svnbook.com/">http://www.svnbook.com/</a>.</p>
</div>
</body>
</html>

133
pdf/NWS_Documentation/Subversion/1. 7 svn-book-html-chunk/SV3CB8~1.HTM Normal file
View file

@ -0,0 +1,133 @@
<?xml version="1.0" encoding="utf-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>svnadmin upgrade</title>
<link rel="stylesheet" href="styles.css" type="text/css" />
<meta name="generator" content="DocBook XSL Stylesheets V1.75.2" />
<style type="text/css">
body { background-image: url('images/draft.png');
background-repeat: no-repeat;
background-position: top left;
/* The following properties make the watermark "fixed" on the page. */
/* I think that's just a bit too distracting for the reader... */
/* background-attachment: fixed; */
/* background-position: center center; */
}</style>
<link rel="home" href="index.html" title="Version Control with Subversion [DRAFT]" />
<link rel="up" href="svn.ref.svnadmin.html#svn.ref.svnadmin.c" title="svnadmin Subcommands" />
<link rel="prev" href="svn.ref.svnadmin.c.setuuid.html" title="svnadmin setuuid" />
<link rel="next" href="svn.ref.svnadmin.c.verify.html" title="svnadmin verify" />
</head>
<body>
<div class="navheader">
<table width="100%" summary="Navigation header">
<tr>
<th colspan="3" align="center">svnadmin upgrade</th>
</tr>
<tr>
<td width="20%" align="left"><a accesskey="p" href="svn.ref.svnadmin.c.setuuid.html">Prev</a> </td>
<th width="60%" align="center">svnadmin Subcommands</th>
<td width="20%" align="right"> <a accesskey="n" href="svn.ref.svnadmin.c.verify.html">Next</a></td>
</tr>
</table>
<hr />
</div>
<div class="refentry" title="svnadmin upgrade">
<a id="svn.ref.svnadmin.c.upgrade"></a>
<div class="titlepage"></div>
<a id="idp43893216" class="indexterm"></a>
<div class="refnamediv">
<h2>Name</h2>
<p>svnadmin upgrade — Upgrade a repository to the latest supported
schema version.</p>
</div>
<div class="refsect1" title="Synopsis">
<a id="idp43896400"></a>
<h2>Synopsis</h2>
<p>
<code class="literal">svnadmin upgrade REPOS_PATH</code>
</p>
</div>
<div class="refsect1" title="Description">
<a id="idp43897984"></a>
<h2>Description</h2>
<p>Upgrade the repository located
at <em class="replaceable"><code>REPOS_PATH</code></em> to the latest
supported schema version.</p>
<p>This functionality is provided as a convenience for
repository administrators who wish to make use of new
Subversion functionality without having to undertake a
potentially costly full repository dump and load
operation. As such, the upgrade performs only the minimum
amount of work needed to accomplish this while still
maintaining the integrity of the repository. While a dump
and subsequent load guarantee the most optimized
repository state, <span class="command"><strong>svnadmin upgrade</strong></span> does
not.</p>
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<table border="0" summary="Warning">
<tr>
<td rowspan="2" align="center" valign="top" width="25">
<img alt="[Warning]" src="images/warning.png" />
</td>
<th align="left">Warning</th>
</tr>
<tr>
<td align="left" valign="top">
<p>You should <span class="emphasis"><em>always</em></span> back up your
repository before upgrading.</p>
</td>
</tr>
</table>
</div>
</div>
<div class="refsect1" title="Options">
<a id="idp43902672"></a>
<h2>Options</h2>
<p>None</p>
</div>
<div class="refsect1" title="Examples">
<a id="idp43903888"></a>
<h2>Examples</h2>
<p>Upgrade the repository at
path <code class="filename">/var/repos/svn</code>:</p>
<div class="informalexample">
<pre class="screen">
$ svnadmin upgrade /var/repos/svn
Repository lock acquired.
Please wait; upgrading the repository may take some time...
Upgrade completed.
</pre>
</div>
</div>
</div>
<div class="navfooter">
<hr />
<table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left"><a accesskey="p" href="svn.ref.svnadmin.c.setuuid.html">Prev</a> </td>
<td width="20%" align="center">
<a accesskey="u" href="svn.ref.svnadmin.html#svn.ref.svnadmin.c">Up</a>
</td>
<td width="40%" align="right"> <a accesskey="n" href="svn.ref.svnadmin.c.verify.html">Next</a></td>
</tr>
<tr>
<td width="40%" align="left" valign="top">svnadmin setuuid </td>
<td width="20%" align="center">
<a accesskey="h" href="index.html">Home</a>
</td>
<td width="40%" align="right" valign="top"> svnadmin verify</td>
</tr>
</table>
</div>
<div xmlns="" id="svn-footer">
<hr />
<p>You are reading <em>Version Control with Subversion</em> (for Subversion 1.7), by Ben Collins-Sussman, Brian W. Fitzpatrick, and C. Michael Pilato.<br />
This work is licensed under the <a href="http://creativecommons.org/licenses/by/2.0/">Creative Commons Attribution License v2.0</a>.<br />
To submit comments, corrections, or other contributions to the text, please visit <a href="http://www.svnbook.com/">http://www.svnbook.com/</a>.</p>
</div>
</body>
</html>

119
pdf/NWS_Documentation/Subversion/1. 7 svn-book-html-chunk/SV4037~1.HTM Normal file
View file

@ -0,0 +1,119 @@
<?xml version="1.0" encoding="utf-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>svnlook filesize</title>
<link rel="stylesheet" href="styles.css" type="text/css" />
<meta name="generator" content="DocBook XSL Stylesheets V1.75.2" />
<style type="text/css">
body { background-image: url('images/draft.png');
background-repeat: no-repeat;
background-position: top left;
/* The following properties make the watermark "fixed" on the page. */
/* I think that's just a bit too distracting for the reader... */
/* background-attachment: fixed; */
/* background-position: center center; */
}</style>
<link rel="home" href="index.html" title="Version Control with Subversion [DRAFT]" />
<link rel="up" href="svn.ref.svnlook.html#svn.ref.svnlook.c" title="svnlook Subcommands" />
<link rel="prev" href="svn.ref.svnlook.c.dirs-changed.html" title="svnlook dirs-changed" />
<link rel="next" href="svn.ref.svnlook.c.help.html" title="svnlook help" />
</head>
<body>
<div class="navheader">
<table width="100%" summary="Navigation header">
<tr>
<th colspan="3" align="center">svnlook filesize</th>
</tr>
<tr>
<td width="20%" align="left"><a accesskey="p" href="svn.ref.svnlook.c.dirs-changed.html">Prev</a> </td>
<th width="60%" align="center">svnlook Subcommands</th>
<td width="20%" align="right"> <a accesskey="n" href="svn.ref.svnlook.c.help.html">Next</a></td>
</tr>
</table>
<hr />
</div>
<div class="refentry" title="svnlook filesize">
<a id="svn.ref.svnlook.c.filesize"></a>
<div class="titlepage"></div>
<a id="idp44044736" class="indexterm"></a>
<div class="refnamediv">
<h2>Name</h2>
<p>svnlook filesize — Print the size (in bytes) of a versioned
file.</p>
</div>
<div class="refsect1" title="Synopsis">
<a id="idp44047904"></a>
<h2>Synopsis</h2>
<p>
<code class="literal">svnlook filesize REPOS_PATH
PATH_IN_REPOS</code>
</p>
</div>
<div class="refsect1" title="Description">
<a id="idp44049552"></a>
<h2>Description</h2>
<p>Print the file size (in bytes) of the file located
at <em class="replaceable"><code>PATH_IN_REPOS</code></em> in the HEAD
revision of the repository identified
by <em class="replaceable"><code>REPOS_PATH</code></em> as a base-10
integer followed by an end-of-line character. Use
the <code class="option">--revision</code> (<code class="option">-r</code>)
and <code class="option">--transaction</code> (<code class="option">-t</code>)
options to specify a version of the file other than HEAD
whose file size you wish to display.</p>
</div>
<div class="refsect1" title="Options">
<a id="idp44053616"></a>
<h2>Options</h2>
<div class="informalexample">
<pre class="screen">
--revision (-r) REV
--transaction (-t) TXN
</pre>
</div>
</div>
<div class="refsect1" title="Examples">
<a id="idp44055520"></a>
<h2>Examples</h2>
<p>The following demonstrates how to display the size of
the <code class="filename">trunk/vendors/deli/soda.txt</code> file
as it appeared in revision 40 of our sample
repository:</p>
<div class="informalexample">
<pre class="screen">
$ svnlook filesize -r 40 /var/svn/repos trunk/vendors/deli/soda.txt
23
$
</pre>
</div>
</div>
</div>
<div class="navfooter">
<hr />
<table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left"><a accesskey="p" href="svn.ref.svnlook.c.dirs-changed.html">Prev</a> </td>
<td width="20%" align="center">
<a accesskey="u" href="svn.ref.svnlook.html#svn.ref.svnlook.c">Up</a>
</td>
<td width="40%" align="right"> <a accesskey="n" href="svn.ref.svnlook.c.help.html">Next</a></td>
</tr>
<tr>
<td width="40%" align="left" valign="top">svnlook dirs-changed </td>
<td width="20%" align="center">
<a accesskey="h" href="index.html">Home</a>
</td>
<td width="40%" align="right" valign="top"> svnlook help</td>
</tr>
</table>
</div>
<div xmlns="" id="svn-footer">
<hr />
<p>You are reading <em>Version Control with Subversion</em> (for Subversion 1.7), by Ben Collins-Sussman, Brian W. Fitzpatrick, and C. Michael Pilato.<br />
This work is licensed under the <a href="http://creativecommons.org/licenses/by/2.0/">Creative Commons Attribution License v2.0</a>.<br />
To submit comments, corrections, or other contributions to the text, please visit <a href="http://www.svnbook.com/">http://www.svnbook.com/</a>.</p>
</div>
</body>
</html>

236
pdf/NWS_Documentation/Subversion/1. 7 svn-book-html-chunk/SV465B~1.HTM Normal file
View file

@ -0,0 +1,236 @@
<?xml version="1.0" encoding="utf-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>High-level Logging</title>
<link rel="stylesheet" href="styles.css" type="text/css" />
<meta name="generator" content="DocBook XSL Stylesheets V1.75.2" />
<style type="text/css">
body { background-image: url('images/draft.png');
background-repeat: no-repeat;
background-position: top left;
/* The following properties make the watermark "fixed" on the page. */
/* I think that's just a bit too distracting for the reader... */
/* background-attachment: fixed; */
/* background-position: center center; */
}</style>
<link rel="home" href="index.html" title="Version Control with Subversion [DRAFT]" />
<link rel="up" href="svn.serverconfig.html" title="Chapter 6. Server Configuration" />
<link rel="prev" href="svn.serverconfig.pathbasedauthz.html" title="Path-Based Authorization" />
<link rel="next" href="svn.serverconfig.optimization.html" title="Server Optimization" />
</head>
<body>
<div class="navheader">
<table width="100%" summary="Navigation header">
<tr>
<th colspan="3" align="center">High-level Logging</th>
</tr>
<tr>
<td width="20%" align="left"><a accesskey="p" href="svn.serverconfig.pathbasedauthz.html">Prev</a> </td>
<th width="60%" align="center">Chapter 6. Server Configuration</th>
<td width="20%" align="right"> <a accesskey="n" href="svn.serverconfig.optimization.html">Next</a></td>
</tr>
</table>
<hr />
</div>
<div class="sect1" title="High-level Logging">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a id="svn.serverconfig.operational-logging"></a>High-level Logging</h2>
</div>
</div>
</div>
<p>Both the Apache <span class="command"><strong>httpd</strong></span>
and <span class="command"><strong>svnserve</strong></span> Subversion servers provide
support for high-level logging of Subversion operations.
Configuring each of the server options to provide this level of
logging is done differently, of course, but the output from each
is designed to conform to a uniform syntax.</p>
<p>To enable high-level logging in <span class="command"><strong>svnserve</strong></span>,
you need only use the <code class="option">--log-file</code> command-line
option when starting the server, passing as the value to the
option the file to which <span class="command"><strong>svnserve</strong></span> should
write its log output.</p>
<div class="informalexample">
<pre class="screen">
$ svnserve -d -r /path/to/repositories --log-file /var/log/svn.log
</pre>
</div>
<p>Enabling the same in Apache is a bit more involved, but is
essentially an extension of Apache's stock log output
configuration mechanisms—see
<a class="xref" href="svn.serverconfig.httpd.html#svn.serverconfig.httpd.extra.logging" title="Apache logging">the section called “Apache logging”</a> for
details.</p>
<p>The following is a list of Subversion action log messages
produced by its high-level logging mechanism, followed by one or
more examples of the log message as it appears in the log
output.</p>
<div class="variablelist">
<dl>
<dt>
<span class="term">Checkout or export</span>
</dt>
<dd>
<pre class="programlisting">
checkout-or-export /path r62 depth=infinity
</pre>
</dd>
<dt>
<span class="term">Commit</span>
</dt>
<dd>
<pre class="programlisting">
commit harry r100
</pre>
</dd>
<dt>
<span class="term">Diffs</span>
</dt>
<dd>
<pre class="programlisting">
diff /path r15:20 depth=infinity ignore-ancestry
diff /path1@15 /path2@20 depth=infinity ignore-ancestry
</pre>
</dd>
<dt>
<span class="term">Fetch a directory</span>
</dt>
<dd>
<pre class="programlisting">
get-dir /trunk r17 text
</pre>
</dd>
<dt>
<span class="term">Fetch a file</span>
</dt>
<dd>
<pre class="programlisting">
get-file /path r20 props
</pre>
</dd>
<dt>
<span class="term">Fetch a file revision</span>
</dt>
<dd>
<pre class="programlisting">
get-file-revs /path r12:15 include-merged-revisions
</pre>
</dd>
<dt>
<span class="term">Fetch merge information</span>
</dt>
<dd>
<pre class="programlisting">
get-mergeinfo (/path1 /path2)
</pre>
</dd>
<dt>
<span class="term">Lock</span>
</dt>
<dd>
<pre class="programlisting">
lock /path steal
</pre>
</dd>
<dt>
<span class="term">Log</span>
</dt>
<dd>
<pre class="programlisting">
log (/path1,/path2,/path3) r20:90 discover-changed-paths revprops=()
</pre>
</dd>
<dt>
<span class="term">Replay revisions (svnsync)</span>
</dt>
<dd>
<pre class="programlisting">
replay /path r19
</pre>
</dd>
<dt>
<span class="term">Revision property change</span>
</dt>
<dd>
<pre class="programlisting">
change-rev-prop r50 propertyname
</pre>
</dd>
<dt>
<span class="term">Revision property list</span>
</dt>
<dd>
<pre class="programlisting">
rev-proplist r34
</pre>
</dd>
<dt>
<span class="term">Status</span>
</dt>
<dd>
<pre class="programlisting">
status /path r62 depth=infinity
</pre>
</dd>
<dt>
<span class="term">Switch</span>
</dt>
<dd>
<pre class="programlisting">
switch /pathA /pathB@50 depth=infinity
</pre>
</dd>
<dt>
<span class="term">Unlock</span>
</dt>
<dd>
<pre class="programlisting">
unlock /path break
</pre>
</dd>
<dt>
<span class="term">Update</span>
</dt>
<dd>
<pre class="programlisting">
update /path r17 send-copyfrom-args
</pre>
</dd>
</dl>
</div>
<p>As a convenience to administrators who wish to post-process
their Subversion high-level logging output (perhaps for
reporting or analysis purposes), Subversion source code
distributions provide a Python module (located at
<code class="filename">tools/server-side/svn_server_log_parse.py</code>)
which can be used to parse Subversion's log output.</p>
</div>
<div class="navfooter">
<hr />
<table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left"><a accesskey="p" href="svn.serverconfig.pathbasedauthz.html">Prev</a> </td>
<td width="20%" align="center">
<a accesskey="u" href="svn.serverconfig.html">Up</a>
</td>
<td width="40%" align="right"> <a accesskey="n" href="svn.serverconfig.optimization.html">Next</a></td>
</tr>
<tr>
<td width="40%" align="left" valign="top">Path-Based Authorization </td>
<td width="20%" align="center">
<a accesskey="h" href="index.html">Home</a>
</td>
<td width="40%" align="right" valign="top"> Server Optimization</td>
</tr>
</table>
</div>
<div xmlns="" id="svn-footer">
<hr />
<p>You are reading <em>Version Control with Subversion</em> (for Subversion 1.7), by Ben Collins-Sussman, Brian W. Fitzpatrick, and C. Michael Pilato.<br />
This work is licensed under the <a href="http://creativecommons.org/licenses/by/2.0/">Creative Commons Attribution License v2.0</a>.<br />
To submit comments, corrections, or other contributions to the text, please visit <a href="http://www.svnbook.com/">http://www.svnbook.com/</a>.</p>
</div>
</body>
</html>

Some files were not shown because too many files have changed in this diff Show more