Re: Documentation for targets "rebuild" and "retest"

[Aleksey Cheusov <vle%gmx.net@localhost>]

 >> Unless any one object I'll commit the following

 >> +	<listitem>
 >> +	  <para>If you did a <command>make build</command> and you
 >> +	  noticed some further modifications of sources are needed,
 >> +	  you can repeat the build with this target, which will ignore
 >> +	  the <quote>already build</quote> flag. This target is

> already build -> already built

Done

 >> +	  helpful while working of patches.</para>

> of patches -> with patches

Done

>> +	<listitem>
 >> +	  <para>If you did a <command>make test</command> and you
 >> +	  noticed some further modifications of sources are needed,
 >> +	  you can repeat the test with this target, which will ignore
 >> +	  the <quote>already tested</quote> flag. This target is
 >> +	  helpful while working of patches.</para>

> Same here.

Done

> I never use retest because if the test fails, the 'already tested'
> flag is not set.

> Can you please also document 'make repackage'?

See attachement.

P.S.
For the same reason we may also implement reconfigure.

Index: files/build.xml
===================================================================
RCS file: /cvsroot/pkgsrc/doc/guide/files/build.xml,v
retrieving revision 1.89
diff -u -r1.89 build.xml
--- files/build.xml	20 Jan 2023 12:21:56 -0000	1.89
+++ files/build.xml	6 May 2024 19:09:03 -0000
@@ -1249,6 +1249,43 @@
 	  information on this target.</para>
 	</listitem>
       </varlistentry>
+
+      <varlistentry>
+	<term>rebuild</term>
+
+	<listitem>
+	  <para>If you did a <command>make build</command> and you
+	  noticed some further modifications of sources are needed,
+	  you can repeat the build with this target, which will ignore
+	  the <quote>already built</quote> flag. This target is
+	  helpful while working with patches.</para>
+	</listitem>
+      </varlistentry>
+
+      <varlistentry>
+	<term>repackage</term>
+
+	<listitem>
+	  <para>If you did a <command>make package</command> and you
+	  noticed some further modifications of sources are needed,
+	  you can repeat the package with this target, which will ignore
+	  the <quote>already packaged</quote> flag. This target is
+	  helpful while working with patches, PLIST* files etc.</para>
+	</listitem>
+      </varlistentry>
+
+      <varlistentry>
+	<term>retest</term>
+
+	<listitem>
+	  <para>If you did a <command>make test</command> and you
+	  noticed some further modifications of sources are needed,
+	  you can repeat the test with this target, which will ignore
+	  the <quote>already tested</quote> flag. This target is
+	  helpful while working with patches.</para>
+	</listitem>
+      </varlistentry>
+
     </variablelist>
   </sect1>
 </chapter>