.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.
+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.
The default scope is determined by the saved option settings for \fB\-B\fR, \fB\-b\fR and \fB\-o\fR.
Some \fIsubject\fR's require \fIarguments\fR.
The following \fIsubject\fR's are available.
.PD 0
.TP
\fB\-\-include\-buildtime\-dependencies\fR
-Include build-time dependencies in evaluation of dependencies.
+Include build\-time dependencies in evaluation of dependencies.
This option affects behaviors of \fB\-t\fR, \fB\-T\fR and \fB\-q\fR options.
.PD
.IP \fB\-C\fR
.PD 0
.TP
\fB\-\-target\-only\-itself=\fR\fIglob1\fR[\fB:\fIglob2\fR[\fB:\fR...]]
-Restrict (re/de)installation within a scope consisting of the specified target ports and their missing build-time requirements.
+Restrict (re/de)installation within a scope consisting of the specified target ports and their missing build\-time requirements.
Available ports matching the specified target globs are automatically registered as necessary ports equivalently to \fBportsreinstall need add\fR command.
+Records of successful (re)installation for the all ports in the scope are deleted so that they are to be reinstalled forcedly.
+So this option is usable for fixing packages whose data in the package database or content files are broken.
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.
\fB\-\-only\-target\-scope\fR
Ignore ports which are outside of target scopes of \fB\-O\fR, \fB\-T\fR or \fB\-t\fR options.
Inspection of dependencies is made within the least-required scope for (re)installing the targets.
-If given with \fB\-O\fR, targets themselves and their missing direct build-time requirements are in the scope.
-If given with \fB\-T\fR, targets themselves, their direct requirements and their missing direct build-time requirements are in the scope.
-If given with \fB\-t\fR, targets themselves, their already-inspected dependents and their missing direct build-time requirements are in the scope.
+If given with \fB\-O\fR, targets themselves and their missing direct build\-time requirements are in the scope.
+If given with \fB\-T\fR, targets themselves, their direct requirements and their missing direct build\-time requirements are in the scope.
+If given with \fB\-t\fR, targets themselves, their already-inspected dependents and their missing direct build\-time requirements are in the scope.
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.
.PD 0
.TP
\fB\-\-target\-and\-requirements=\fR\fIglob1\fR[\fB:\fIglob2\fR[\fB:\fR...]]
-Restrict (re/de)installation within a scope consisting of the specified target ports, their requirements and their missing build-time requirements.
+Restrict (re/de)installation within a scope consisting of the specified target ports, their requirements and their missing build\-time requirements.
Available ports matching the specified target globs are automatically registered as necessary ports equivalently to \fBportsreinstall need add\fR command.
+Records of successful (re)installation for the all ports in the scope are deleted so that they are to be reinstalled forcedly.
+So this option is usable for fixing packages whose data in the package database or content files are broken.
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.
.PD 0
.TP
\fB\-\-target\-and\-dependents=\fR\fIglob1\fR[\fB:\fIglob2\fR[\fB:\fR...]]
-Restrict (re/de)installation within a scope consisting of the specified target ports, their dependents and their missing build-time requirements.
+Restrict (re/de)installation within a scope consisting of the specified target ports, their dependents and their missing build\-time requirements.
Available ports matching the specified target globs are automatically registered as necessary ports equivalently to \fBportsreinstall need add\fR command.
+Records of successful (re)installation for the all ports in the scope are deleted so that they are to be reinstalled forcedly.
+So this option is usable for fixing packages whose data in the package database or content files are broken.
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.
.SH HISTORY
\fBportsreinstall\fR has been developed as below.
.TP
-3.0.1 (? June 2013)
+3.0.1 (11 June 2013)
[NEW] Commands \fBescape\fR and \fBrestore\fR are added.
[IMPROVED] The behavior of \fB\-C\fR option is changed in case of \fBdialog4ports\fR(1) so that the port options are unchanged and unsaved throughout the all stages from the temporary database build to (re)installation. This allows the all stages to run on \fBscript\fR(1) and \fBnohup\fR(1).
[CHANGED] Compact forms of options is made to be accepted, e.g., \fB\-b \-t \-o\fR as \fB\-bto\fR.
-[CHANGED] The behaviors of \fB\-q\fR, \fB\-t\fR and \fB\-T\fR options are changed to ignore build-time-only dependencies. The former function is reproduced with \fB\-b\fR option. The document for \fB\-t\fR and \fB\-T\fR options are revised so as to correct wrong descriptions that they could newly install the specified ports.
+[CHANGED] The behaviors of \fB\-q\fR, \fB\-t\fR and \fB\-T\fR options are changed to ignore build\-time-only dependencies. The former function is reproduced with \fB\-b\fR option. The document for \fB\-t\fR and \fB\-T\fR options are revised so as to correct wrong descriptions that they could newly install the specified ports.
[CHANGED] Syntax of \fB\-t\fR and \fB\-T\fR options are changed so as to give all port globs by a single argument value as concatenation with colons as delimiters. Along this change, \fB\-r\fR and \fB\-R\fR options are abandoned.