<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head><meta http-equiv="content-type" content="text/html; charset=utf-8" /><style type="text/css"><!--
#msg dl { border: 1px #006 solid; background: #369; padding: 6px; color: #fff; }
#msg dt { float: left; width: 6em; font-weight: bold; }
#msg dt:after { content:':';}
#msg dl, #msg dt, #msg ul, #msg li, #header, #footer { font-family: verdana,arial,helvetica,sans-serif; font-size: 10pt;  }
#msg dl a { font-weight: bold}
#msg dl a:link    { color:#fc3; }
#msg dl a:active  { color:#ff0; }
#msg dl a:visited { color:#cc6; }
h3 { font-family: verdana,arial,helvetica,sans-serif; font-size: 10pt; font-weight: bold; }
#msg pre, #msg p { overflow: auto; background: #ffc; border: 1px #fc0 solid; padding: 6px; }
#msg ul { overflow: auto; }
#header, #footer { color: #fff; background: #636; border: 1px #300 solid; padding: 6px; }
#patch { width: 100%; }
#patch h4 {font-family: verdana,arial,helvetica,sans-serif;font-size:10pt;padding:8px;background:#369;color:#fff;margin:0;}
#patch .propset h4, #patch .binary h4 {margin:0;}
#patch pre {padding:0;line-height:1.2em;margin:0;}
#patch .diff {width:100%;background:#eee;padding: 0 0 10px 0;overflow:auto;}
#patch .propset .diff, #patch .binary .diff  {padding:10px 0;}
#patch span {display:block;padding:0 10px;}
#patch .modfile, #patch .addfile, #patch .delfile, #patch .propset, #patch .binary, #patch .copfile {border:1px solid #ccc;margin:10px 0;}
#patch ins {background:#dfd;text-decoration:none;display:block;padding:0 10px;}
#patch del {background:#fdd;text-decoration:none;display:block;padding:0 10px;}
#patch .lines, .info {color:#888;background:#fff;}
--></style>
<title>[31862] trunk/doc-new/guide/xml/portfileref.xml</title>
</head>
<body>

<div id="msg">
<dl>
<dt>Revision</dt> <dd><a href="http://trac.macosforge.org/projects/macports/changeset/31862">31862</a></dd>
<dt>Author</dt> <dd>simon@macports.org</dd>
<dt>Date</dt> <dd>2007-12-10 06:25:57 -0800 (Mon, 10 Dec 2007)</dd>
</dl>

<h3>Log Message</h3>
<pre>doc-new: Use &lt;replaceable&gt; in the &quot;Tcl extension&quot; section. Thanks to Ryan Schmidt for the idea. Also fixed an id.</pre>

<h3>Modified Paths</h3>
<ul>
<li><a href="#trunkdocnewguidexmlportfilerefxml">trunk/doc-new/guide/xml/portfileref.xml</a></li>
</ul>

</div>
<div id="patch">
<h3>Diff</h3>
<a id="trunkdocnewguidexmlportfilerefxml"></a>
<div class="modfile"><h4>Modified: trunk/doc-new/guide/xml/portfileref.xml (31861 => 31862)</h4>
<pre class="diff"><span>
<span class="info">--- trunk/doc-new/guide/xml/portfileref.xml        2007-12-10 14:09:31 UTC (rev 31861)
+++ trunk/doc-new/guide/xml/portfileref.xml        2007-12-10 14:25:57 UTC (rev 31862)
</span><span class="lines">@@ -163,7 +163,7 @@
</span><span class="cx">     &lt;/section&gt;
</span><span class="cx">   &lt;/section&gt;
</span><span class="cx"> 
</span><del>-  &lt;section id=&quot;reference.tcl-extensions&quot;&gt;
</del><ins>+  &lt;section id=&quot;reference.tcl-extensions-old&quot;&gt;
</ins><span class="cx">     &lt;title&gt;Tcl Extensions&lt;/title&gt;
</span><span class="cx"> 
</span><span class="cx">     &lt;para&gt;A MacPorts Portfile is a Tcl script, so it may contain any arbitrary
</span><span class="lines">@@ -297,8 +297,10 @@
</span><span class="cx"> 
</span><span class="cx">             &lt;variablelist&gt;
</span><span class="cx">               &lt;varlistentry&gt;
</span><del>-                &lt;term&gt;xinstall [-o owner] [-g group] [-m mode] [file1 file2
-                ...] directory&lt;/term&gt;
</del><ins>+                &lt;term&gt;xinstall [-o &lt;replaceable&gt;owner&lt;/replaceable&gt;] [-g
+                &lt;replaceable&gt;group&lt;/replaceable&gt;] [-m
+                &lt;replaceable&gt;mode&lt;/replaceable&gt;] [&lt;replaceable&gt;file1 file2
+                ...&lt;/replaceable&gt;] &lt;replaceable&gt;directory&lt;/replaceable&gt;&lt;/term&gt;
</ins><span class="cx"> 
</span><span class="cx">                 &lt;listitem&gt;
</span><span class="cx">                   &lt;para&gt;Install the specified file(s) to a destination
</span><span class="lines">@@ -309,8 +311,11 @@
</span><span class="cx"> 
</span><span class="cx">             &lt;variablelist&gt;
</span><span class="cx">               &lt;varlistentry&gt;
</span><del>-                &lt;term&gt;xinstall [-o owner] [-g group] [-m mode] [-W dir] [file1
-                file2 ...] directory&lt;/term&gt;
</del><ins>+                &lt;term&gt;xinstall [-o &lt;replaceable&gt;owner&lt;/replaceable&gt;] [-g
+                &lt;replaceable&gt;group&lt;/replaceable&gt;] [-m
+                &lt;replaceable&gt;mode&lt;/replaceable&gt;] [-W
+                &lt;replaceable&gt;dir&lt;/replaceable&gt;] [&lt;replaceable&gt;file1 file2
+                ...&lt;/replaceable&gt;] &lt;replaceable&gt;directory&lt;/replaceable&gt;&lt;/term&gt;
</ins><span class="cx"> 
</span><span class="cx">                 &lt;listitem&gt;
</span><span class="cx">                   &lt;para&gt;Change to &lt;option&gt;dir&lt;/option&gt; and install file(s) to
</span><span class="lines">@@ -321,8 +326,11 @@
</span><span class="cx"> 
</span><span class="cx">             &lt;variablelist&gt;
</span><span class="cx">               &lt;varlistentry&gt;
</span><del>-                &lt;term&gt;eval xinstall [-o owner] [-g group] [-m mode] [glob
-                pattern] directory&lt;/term&gt;
</del><ins>+                &lt;term&gt;eval xinstall [-o &lt;replaceable&gt;owner&lt;/replaceable&gt;] [-g
+                &lt;replaceable&gt;group&lt;/replaceable&gt;] [-m
+                &lt;replaceable&gt;mode&lt;/replaceable&gt;] [glob
+                &lt;replaceable&gt;pattern&lt;/replaceable&gt;]
+                &lt;replaceable&gt;directory&lt;/replaceable&gt;&lt;/term&gt;
</ins><span class="cx"> 
</span><span class="cx">                 &lt;listitem&gt;
</span><span class="cx">                   &lt;para&gt;Install the file(s) matching the glob pattern to a
</span><span class="lines">@@ -333,8 +341,10 @@
</span><span class="cx"> 
</span><span class="cx">             &lt;variablelist&gt;
</span><span class="cx">               &lt;varlistentry&gt;
</span><del>-                &lt;term&gt;xinstall -d [-o owner] [-g group] [-m mode]
-                directory&lt;/term&gt;
</del><ins>+                &lt;term&gt;xinstall -d [-o &lt;replaceable&gt;owner&lt;/replaceable&gt;] [-g
+                &lt;replaceable&gt;group&lt;/replaceable&gt;] [-m
+                &lt;replaceable&gt;mode&lt;/replaceable&gt;]
+                &lt;replaceable&gt;directory&lt;/replaceable&gt;&lt;/term&gt;
</ins><span class="cx"> 
</span><span class="cx">                 &lt;listitem&gt;
</span><span class="cx">                   &lt;para&gt;Create a directory.&lt;/para&gt;
</span><span class="lines">@@ -397,8 +407,12 @@
</span><span class="cx"> 
</span><span class="cx">             &lt;variablelist&gt;
</span><span class="cx">               &lt;varlistentry&gt;
</span><del>-                &lt;term&gt;adduser username [uid=uid] [gid=gid] [passwd=passwd]
-                [realname=realname] [home=home] [shell=shell]&lt;/term&gt;
</del><ins>+                &lt;term&gt;adduser username [uid=&lt;replaceable&gt;uid&lt;/replaceable&gt;]
+                [gid=&lt;replaceable&gt;gid&lt;/replaceable&gt;]
+                [passwd=&lt;replaceable&gt;passwd&lt;/replaceable&gt;]
+                [realname=&lt;replaceable&gt;realname&lt;/replaceable&gt;]
+                [home=&lt;replaceable&gt;home&lt;/replaceable&gt;]
+                [shell=&lt;replaceable&gt;shell&lt;/replaceable&gt;]&lt;/term&gt;
</ins><span class="cx"> 
</span><span class="cx">                 &lt;listitem&gt;
</span><span class="cx">                   &lt;para&gt;Add a new local user to the system with the specified
</span><span class="lines">@@ -410,7 +424,7 @@
</span><span class="cx"> 
</span><span class="cx">             &lt;variablelist&gt;
</span><span class="cx">               &lt;varlistentry&gt;
</span><del>-                &lt;term&gt;existsuser username&lt;/term&gt;
</del><ins>+                &lt;term&gt;existsuser &lt;replaceable&gt;username&lt;/replaceable&gt;&lt;/term&gt;
</ins><span class="cx"> 
</span><span class="cx">                 &lt;listitem&gt;
</span><span class="cx">                   &lt;para&gt;Check if a local user exists.&lt;/para&gt;
</span><span class="lines">@@ -430,8 +444,11 @@
</span><span class="cx"> 
</span><span class="cx">             &lt;variablelist&gt;
</span><span class="cx">               &lt;varlistentry&gt;
</span><del>-                &lt;term&gt;addgroup group [gid=gid] [passwd=passwd]
-                [realname=realname] [users=users]&lt;/term&gt;
</del><ins>+                &lt;term&gt;addgroup &lt;replaceable&gt;group&lt;/replaceable&gt;
+                [gid=&lt;replaceable&gt;gid&lt;/replaceable&gt;]
+                [passwd=&lt;replaceable&gt;passwd&lt;/replaceable&gt;]
+                [realname=&lt;replaceable&gt;realname&lt;/replaceable&gt;]
+                [users=&lt;replaceable&gt;users&lt;/replaceable&gt;]&lt;/term&gt;
</ins><span class="cx"> 
</span><span class="cx">                 &lt;listitem&gt;
</span><span class="cx">                   &lt;para&gt;Add a new local group to the system, with the
</span><span class="lines">@@ -443,7 +460,7 @@
</span><span class="cx"> 
</span><span class="cx">             &lt;variablelist&gt;
</span><span class="cx">               &lt;varlistentry&gt;
</span><del>-                &lt;term&gt;existsgroup group&lt;/term&gt;
</del><ins>+                &lt;term&gt;existsgroup &lt;replaceable&gt;group&lt;/replaceable&gt;&lt;/term&gt;
</ins><span class="cx"> 
</span><span class="cx">                 &lt;listitem&gt;
</span><span class="cx">                   &lt;para&gt;Check if a local group exists and return the
</span></span></pre>
</div>
</div>

</body>
</html>