[50773] branches/new-help-system/base/doc

raimue at macports.org raimue at macports.org
Fri May 8 18:58:55 PDT 2009


Revision: 50773
          http://trac.macports.org/changeset/50773
Author:   raimue at macports.org
Date:     2009-05-08 18:58:55 -0700 (Fri, 08 May 2009)
Log Message:
-----------
doc:
Add 'port activate' and 'port deactivate'

Modified Paths:
--------------
    branches/new-help-system/base/doc/Makefile

Added Paths:
-----------
    branches/new-help-system/base/doc/images.txt
    branches/new-help-system/base/doc/port-activate.1
    branches/new-help-system/base/doc/port-activate.1.txt
    branches/new-help-system/base/doc/port-deactivate.1
    branches/new-help-system/base/doc/port-deactivate.1.txt

Modified: branches/new-help-system/base/doc/Makefile
===================================================================
--- branches/new-help-system/base/doc/Makefile	2009-05-09 01:55:54 UTC (rev 50772)
+++ branches/new-help-system/base/doc/Makefile	2009-05-09 01:58:55 UTC (rev 50773)
@@ -1,5 +1,7 @@
 A2X=		a2x
 MAN1=		port.1 \
+		port-activate.1 \
+		port-deactivate.1 \
 		port-install.1 \
 		port-uninstall.1
 MAN5=		macports.conf.5
@@ -40,7 +42,7 @@
 	gzip -c $^ > $@
 
 %.1 %.1.xml: %.1.txt
-	$(A2X) --asciidoc-opts='-f asciidoc.conf' -f manpage $<
+	$(A2X) --asciidoc-opts='-f asciidoc.conf' --xsltproc-opts='-o $@' -f manpage $<
 
 %.5 %.5.xml: %.5.txt
 	$(A2X) --asciidoc-opts='-f asciidoc.conf' -f manpage $<

Added: branches/new-help-system/base/doc/images.txt
===================================================================
--- branches/new-help-system/base/doc/images.txt	                        (rev 0)
+++ branches/new-help-system/base/doc/images.txt	2009-05-09 01:58:55 UTC (rev 50773)
@@ -0,0 +1,7 @@
+MacPorts has the ability to install multiple versions or different variant
+selections of the same port. The files will be stored in an intermediate
+location as 'images', which allows to switch between the versions. Only one
+version can be active at a time. On activation, files will be hardlinked to
+their intended place in 'prefix'.
+
+To check the current status of a specific port, use *linkman:port-installed{1}*.


Property changes on: branches/new-help-system/base/doc/images.txt
___________________________________________________________________
Added: svn:keywords
   + Id
Added: svn:eol-style
   + native

Added: branches/new-help-system/base/doc/port-activate.1
===================================================================
--- branches/new-help-system/base/doc/port-activate.1	                        (rev 0)
+++ branches/new-help-system/base/doc/port-activate.1	2009-05-09 01:58:55 UTC (rev 50773)
@@ -0,0 +1,54 @@
+'\" t
+.\"     Title: port-activate
+.\"    Author: [see the "AUTHORS" section]
+.\" Generator: DocBook XSL Stylesheets v1.74.3 <http://docbook.sf.net/>
+.\"      Date: 05/09/2009
+.\"    Manual: MacPorts Manual
+.\"    Source: MacPorts 1.8.0
+.\"  Language: English
+.\"
+.TH "PORT\-ACTIVATE" "1" "05/09/2009" "MacPorts 1\&.8\&.0" "MacPorts Manual"
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
+port-activate \- Activate a previously installed version of a port
+.SH "SYNOPSIS"
+.sp
+.nf
+\fBport\fR [\fB\-vdf\fR] [\fB\-D\fR \fIportdir\fR] \fBactivate\fR
+     [[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
+     [\fI at version\fR]
+.fi
+.SH "DESCRIPTION"
+.sp
+\fBport activate\fR will set the status of an previously installed version of a port to active\&. The passed ports have to reference to already installed versions\&.
+.sp
+MacPorts has the ability to install multiple versions or different variant selections of the same port\&. The files will be stored in an intermediate location as \fIimages\fR, which allows to switch between the versions\&. Only one version can be active at a time\&. On activation, files will be hardlinked to their intended place in \fIprefix\fR\&.
+.sp
+There cannot be another version active at the time of using \fBport activate\fR, you would have to use \fBport deactivate\fR first to deactivate the current active port first\&.
+.SH "GLOBAL OPTIONS"
+.sp
+Please see the section \fBGLOBAL OPTIONS\fR in the port(1) man page for a description of global port options\&.
+.SH "SEE ALSO"
+.sp
+port(1), port\-install(1), port\-installed(1), port\-deactivate(1)
+.SH "AUTHORS"
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+(C) 2009 The MacPorts Project
+(C) 2009 Rainer Mueller <raimue at macports\&.org>
+.fi
+.if n \{\
+.RE
+.\}

Added: branches/new-help-system/base/doc/port-activate.1.txt
===================================================================
--- branches/new-help-system/base/doc/port-activate.1.txt	                        (rev 0)
+++ branches/new-help-system/base/doc/port-activate.1.txt	2009-05-09 01:58:55 UTC (rev 50773)
@@ -0,0 +1,41 @@
+// $Id$
+// vim: set et sw=4 ts=8 syntax=asciidoc tw=80:
+port-activate(1)
+===============
+
+NAME
+----
+port-activate - Activate a previously installed version of a port
+
+SYNOPSIS
+--------
+[verse]
+*port* [*-vdf*] [*-D* 'portdir'] *activate*
+     [['portname' | 'pseudo-portname' | 'port-expressions' | 'port-url']]
+     ['@version']
+
+DESCRIPTION
+-----------
+*port activate* will set the status of an previously installed version of a port
+to active. The passed ports have to reference to already installed versions.
+
+include::images.txt[]
+ 
+// [NOTE]
+There cannot be another version active at the time of using *port activate*, you
+would have to use *port deactivate* first to deactivate the current active port
+first.
+
+
+include::global-flags.txt[]
+
+
+SEE ALSO
+--------
+linkman:port[1], linkman:port-install[1], linkman:port-installed[1],
+linkman:port-deactivate[1]
+
+AUTHORS
+-------
+ (C) 2009 The MacPorts Project
+ (C) 2009 Rainer Mueller <raimue at macports.org>


Property changes on: branches/new-help-system/base/doc/port-activate.1.txt
___________________________________________________________________
Added: svn:keywords
   + Id
Added: svn:eol-style
   + native

Added: branches/new-help-system/base/doc/port-deactivate.1
===================================================================
--- branches/new-help-system/base/doc/port-deactivate.1	                        (rev 0)
+++ branches/new-help-system/base/doc/port-deactivate.1	2009-05-09 01:58:55 UTC (rev 50773)
@@ -0,0 +1,52 @@
+'\" t
+.\"     Title: port-deactivate
+.\"    Author: [see the "AUTHORS" section]
+.\" Generator: DocBook XSL Stylesheets v1.74.3 <http://docbook.sf.net/>
+.\"      Date: 05/09/2009
+.\"    Manual: MacPorts Manual
+.\"    Source: MacPorts 1.8.0
+.\"  Language: English
+.\"
+.TH "PORT\-DEACTIVATE" "1" "05/09/2009" "MacPorts 1\&.8\&.0" "MacPorts Manual"
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
+port-deactivate \- Deactivate the currently active version of a port
+.SH "SYNOPSIS"
+.sp
+.nf
+\fBport\fR [\fB\-vd\fR] [\fB\-D\fR \fIportdir\fR] \fBdeactivate\fR
+     [[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
+.fi
+.SH "DESCRIPTION"
+.sp
+\fBport deactivate\fR will set the status of a port to inactive\&. The passed ports have to be active at the moment\&.
+.sp
+MacPorts has the ability to install multiple versions or different variant selections of the same port\&. The files will be stored in an intermediate location as \fIimages\fR, which allows to switch between the versions\&. Only one version can be active at a time\&. On activation, files will be hardlinked to their intended place in \fIprefix\fR\&.
+.sp
+.SH "GLOBAL OPTIONS"
+.sp
+Please see the section \fBGLOBAL OPTIONS\fR in the port(1) man page for a description of global port options\&.
+.SH "SEE ALSO"
+.sp
+port(1), port\-install(1), port\-installed(1), port\-activate(1)
+.SH "AUTHORS"
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+(C) 2009 The MacPorts Project
+(C) 2009 Rainer Mueller <raimue at macports\&.org>
+.fi
+.if n \{\
+.RE
+.\}

Added: branches/new-help-system/base/doc/port-deactivate.1.txt
===================================================================
--- branches/new-help-system/base/doc/port-deactivate.1.txt	                        (rev 0)
+++ branches/new-help-system/base/doc/port-deactivate.1.txt	2009-05-09 01:58:55 UTC (rev 50773)
@@ -0,0 +1,35 @@
+// $Id$
+// vim: set et sw=4 ts=8 syntax=asciidoc tw=80:
+port-deactivate(1)
+==================
+
+NAME
+----
+port-deactivate - Deactivate the currently active version of a port
+
+SYNOPSIS
+--------
+[verse]
+*port* [*-vd*] [*-D* 'portdir'] *deactivate*
+     [['portname' | 'pseudo-portname' | 'port-expressions' | 'port-url']]
+
+DESCRIPTION
+-----------
+*port deactivate* will set the status of a port to inactive. The passed ports
+have to be active at the moment.
+
+include::images.txt[]
+
+
+include::global-flags.txt[]
+
+
+SEE ALSO
+--------
+linkman:port[1], linkman:port-install[1], linkman:port-installed[1],
+linkman:port-activate[1]
+
+AUTHORS
+-------
+ (C) 2009 The MacPorts Project
+ (C) 2009 Rainer Mueller <raimue at macports.org>


Property changes on: branches/new-help-system/base/doc/port-deactivate.1.txt
___________________________________________________________________
Added: svn:keywords
   + Id
Added: svn:eol-style
   + native
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.macosforge.org/pipermail/macports-changes/attachments/20090508/ae64aedc/attachment.html>


More information about the macports-changes mailing list