<pre style='margin:0'>
Ryan Schmidt (ryandesign) pushed a commit to branch master
in repository macports-base.

</pre>
<p><a href="https://github.com/macports/macports-base/commit/3115e63fac50769ce22aecc9cb0658dd4078f32c">https://github.com/macports/macports-base/commit/3115e63fac50769ce22aecc9cb0658dd4078f32c</a></p>
<pre style="white-space: pre; background: #F8F8F8">The following commit(s) were added to refs/heads/master by this push:
<span style='display:block; white-space:pre;color:#404040;'>     new 3115e63f portfile.7: Improve fs-traverse documentation
</span>3115e63f is described below

<span style='display:block; white-space:pre;color:#808000;'>commit 3115e63fac50769ce22aecc9cb0658dd4078f32c
</span>Author: Ryan Schmidt <ryandesign@macports.org>
AuthorDate: Sun Dec 6 18:38:52 2020 -0600

<span style='display:block; white-space:pre;color:#404040;'>    portfile.7: Improve fs-traverse documentation
</span><span style='display:block; white-space:pre;color:#404040;'>    
</span><span style='display:block; white-space:pre;color:#404040;'>    Describe the -tails and -- flags and note that target-list should always
</span><span style='display:block; white-space:pre;color:#404040;'>    be specified as a list even if it contains only one item.
</span>---
 doc/portfile.7 | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

<span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/portfile.7 b/doc/portfile.7
</span><span style='display:block; white-space:pre;color:#808080;'>index 9f654e5a..af835e94 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/doc/portfile.7
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/portfile.7
</span><span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -2384,6 +2384,8 @@ before working.
</span> .Ic fs-traverse
 .Op Fl depth
 .Op Fl ignoreErrors
<span style='display:block; white-space:pre;background:#e0ffe0;'>+.Op Fl tails
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.Op Fl -
</span> .Ar varname
 .Ar target-list
 .Ar body
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -2393,6 +2395,8 @@ Traverse the filesystem hierarchy rooted in each element of
</span> and execute
 .Ar body
 for each found file/directory.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+.Va target-list
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+should always be specified as a list even if contains only one item.
</span> .Va varname
 is set to the path of the file/directory.
 If
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -2417,6 +2421,17 @@ as it will be processed after its children.
</span> Causes
 .Ic fs-traverse
 to ignore any permissions/read errors encountered during processing.
<span style='display:block; white-space:pre;background:#e0ffe0;'>+.It Fl tails
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+Returns paths relative to the top-level directory being traversed, as opposed to
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+absolute paths. When
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.Fl tails
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+is used
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.Va target-list
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+can contain only one item.
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.It Fl --
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+Ignores any further flags and interprets the next parameter as
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.Va varname
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+even if it begins with a dash.
</span> .El
 .Pp
 If
</pre><pre style='margin:0'>

</pre>