OSDN Git Service

[BUG FIX] Adding packages sometimes failed due to lack of required packages.
[portsreinstall/current.git] / man / portsreinstall.8
index 11f433d..71dd517 100644 (file)
@@ -171,13 +171,6 @@ By default save directory is the current directory.
 Load a temporary database archive.
 Note that the currently temporary database is removed.
 .TP
-\fBglob\fR \fIglob\fR [\fIglob2\fR ...]
-Evaluate port globs and show matched flavored origins both for installed and uninstalled packages.
-.TP
-\fBoptions\fR
-Show saved option settings and expected effects of option-resetting options \fB\-L\fR, \fB\-M\fR and \fB\-N\fR.
-With \fB\-a\fR option, the first, second and third columns denote the option-resetting options, reset options and remaining options, respectively.
-.TP
 \fBrmconf\fR \fIglob\fR [\fIglob2\fR ...]
 Reset port options for the specified ports to the default and reset affected parts in the temporary database.
 .TP
@@ -211,15 +204,6 @@ The escaped packages are registered as taboo as same as \fBtaboo add\fR \fIglob\
 Restore packages specified by \fIglobs\fR escaped by \fBescape\fR command.
 The escaped packages are deregistered from taboo as same as \fBtaboo del\fR \fIglob\fR [\fIglob2\fR ...].
 .TP
-\fBmake\fR \fIglob\fR [\fItarget\fR ...] [\fIarguments\fR ...]
-Execute \fBmake\fR(1) command for ports matching the glob pattern.
-The taget and arguments are passed as they are with the arguments and environment variables customized for each port.
-For flavored ports, the appropriate argument (FLAVOR variable) is automatically set.
-The main purpose of this command is diagnosis and experimental build of unsuccessful ports.
-The result of this command will not be recognized by the (re)installation processes of \fBdo\fR and \fBredo\fR commands.
-The execution is carried out for each matching port in the alphanumeric order.
-If any port failed to execute \fBmake\fR(1) command, its exit status is returned by terminating immediately (so the following ports in the queue are skipped). 
-.TP
 \fBpackupgrade\fR \fBcreate\fR
 Create packages of the all reinstalled or newly installed ports (at a "builder" environment) with a set of scripts for upgrading another system with the same initial configuration of installed packages ("target" environment).
 One of typical examples of application can be such that the builder is a "forked" jail/chroot system constructed onto a host system by using nullfs and unionfs and the target is the host system (Refer to "Package build in a chroot system" Section).
@@ -240,6 +224,27 @@ This does not affect any already cropped sets of scripts or created packages.
 This command is provided for cases that ports/packages are reinstalled or reconfigured during/after the execution of \fBpackupgrade\fR \fBcreate\fR command.
 After execution of this command, \fBpackupgrade\fR \fBcreate\fR command will overwrite the packages by creating them again.
 .TP
+\fBmake\fR \fIglob\fR [\fItarget\fR ...] [\fIarguments\fR ...]
+Execute \fBmake\fR(1) command for ports matching the glob pattern.
+The taget and arguments are passed as they are with the arguments and environment variables customized for each port.
+For flavored ports, the appropriate argument (FLAVOR variable) is automatically set.
+The main purpose of this command is diagnosis and experimental build of unsuccessful ports.
+The result of this command will not be recognized by the (re)installation processes of \fBdo\fR and \fBredo\fR commands.
+The execution is carried out for each matching port in the alphanumeric order.
+If any port failed to execute \fBmake\fR(1) command, its exit status is returned by terminating immediately (so the following ports in the queue are skipped). 
+.TP
+\fBglob\fR \fIglob\fR [\fIglob2\fR ...]
+Evaluate port globs and show matched flavored origins both for installed and uninstalled packages.
+The exit status is always 0.
+.TP
+\fBpkg\fR \fIglob\fR [\fIglob2\fR ...]
+Evaluate port globs and show matched installed package names.
+The returned exit status is 1 if no installed package matches any of the globs.
+.TP
+\fBoptions\fR
+Show saved option settings and expected effects of option-resetting options \fB\-L\fR, \fB\-M\fR and \fB\-N\fR.
+With \fB\-a\fR option, the first, second and third columns denote the option-resetting options, reset options and remaining options, respectively.
+.TP
 \fBshow\fR [\fIsubject\fR] [@[\fBrun\fR|\fBbuild\fR|\fBall\fR][,[\fBdirect\fR|\fBfull\fR]]] [\fIarguments\fR]
 Show the list of ports to be reinstalled.
 The applied scope of dependencies can be controlled by "show option" proceeded by "@"; \fBrun\fR, \fBbuild\fR and \fBall\fR employ the run\-time, build\-time or both-time ones, respectively; \fBdirect\fR and \fBfull\fR include only the direct or fully recursive ones, respectively.
@@ -435,6 +440,7 @@ This option conflicts with \fB\-I\fR.
 \fB\-\-exclude\-runtime\-dependencies\fR
 Exclude run\-time dependencies in evaluation of dependencies.
 This option affects behaviors of \fB\-t\fR, \fB\-T\fR and \fB\-q\fR options.
+Use of this option should be just for temporary diagnosis or salvage because the full-run-time requirements are needed for building a port in principle.
 .PD
 .IP \fB\-b\fR
 .PD 0
@@ -442,6 +448,7 @@ This option affects behaviors of \fB\-t\fR, \fB\-T\fR and \fB\-q\fR options.
 \fB\-\-include\-buildtime\-dependencies\fR
 Include build\-time dependencies in evaluation of dependencies.
 This option affects behaviors of \fB\-t\fR, \fB\-T\fR and \fB\-q\fR options.
+Use of this option will result in installation of the all build-time requirements regardless of the actual necessity for upgrade of installed packages.
 .PD
 .IP \fB\-C\fR
 .PD 0
@@ -593,6 +600,7 @@ Without \fB\-i\fR option, target ports must be already installed or inspected.
 Without \fB\-o\fR option, the temporary database is maintained to have complete data on dependencies of all installed and necessary ports.
 Combination with options \fB\-T\fR and \fB\-t\fR is available.
 The behavior can be modified by \fB\-B\fR, \fB\-b\fR, \fB\-i\fR and \fB\-o\fR options.
+Use of this option should be just for temporary diagnosis or salvage.
 .PD
 .IP \fB\-o\fR
 .PD 0
@@ -606,6 +614,7 @@ If given with \fB\-t\fR, targets themselves, their already-inspected dependents
 Ports outside of the scopes are kept untouched even if they are updated.
 It is noted that this option disables detection and deinstallation of new leaf ports.
 This option will be useful for quick upgrades or new installation (only) before complete construction of the temporary database for the all installed ports.
+Use of this option should be just for temporary diagnosis or salvage.
 .PD
 .IP \fB\-T\fR\ \fIglob1\fR[\fB:\fIglob2\fR[\fB:\fR...]]
 .PD 0
@@ -619,6 +628,7 @@ Without \fB\-i\fR option, target ports must be already installed or inspected.
 Without \fB\-o\fR option, the temporary database is maintained to have complete data on dependencies of all installed and necessary ports.
 Combination with options \fB\-T\fR and \fB\-t\fR is available.
 The behavior can be modified by \fB\-B\fR, \fB\-b\fR, \fB\-i\fR and \fB\-o\fR options.
+Use of this option should be just for temporary diagnosis or salvage.
 .PD
 .IP \fB\-t\fR\ \fIglob1\fR[\fB:\fIglob2\fR[\fB:\fR...]]
 .PD 0
@@ -632,6 +642,7 @@ Without \fB\-i\fR option, target ports must be already installed or inspected.
 Without \fB\-o\fR option, the temporary database is maintained to have complete data on dependencies of all installed and necessary ports.
 Combination with options \fB\-T\fR and \fB\-t\fR is available.
 The behavior can be modified by \fB\-B\fR, \fB\-b\fR, \fB\-i\fR and \fB\-o\fR options.
+Use of this option should be just for temporary diagnosis or salvage.
 .PD
 .SS Group 6: Saved and transferred to restarted runs, renewable by \-L option
 Option settings in this group are saved at the first \fBdo\fR or \fBprepare\fR run, and transferred to the following runs.
@@ -1104,7 +1115,7 @@ Configuration file of \fBportupgrade\fR(1).
 .PP
 [NEW] \fBauto\fR command is added to \fBportsreinstall\-chroot\fR(8).
 .PP
-[NEW] \fBmake\fR, \fBshow errormessage\fR, \fBshow leaves\fR and \fBshow obsolete\fR commands are added.
+[NEW] \fBpkg\fR, \fBmake\fR, \fBshow errormessage\fR, \fBshow leaves\fR and \fBshow obsolete\fR commands are added.
 .PP
 [NEW] BUILDCONFLICT and INSTCONFLICT sections are added to ${LOCALBASE}/etc/portsreinstall.conf.
 .PP
@@ -1124,6 +1135,10 @@ Configuration file of \fBportupgrade\fR(1).
 .PP
 [IMPROVED] The message at the exit from \fBportsreinstall\-chroot\fR(8) builder chroot environment is modified to be less shocking.
 .PP
+[IMPROVED] The batch mode is made more quiet typically about the output of package tools and make.
+.PP
+[BUG FIX] Adding packages sometimes failed due to lack of required packages.
+.PP
 [BUG FIX] \fBreset\fR command discarded the information of the initially installed packages.
 .PP
 [BUG FIX] Dependency inspection might have terminated with error when obsolete ports exist.