Changeset 9355 for branches


Ignore:
Timestamp:
Oct 22, 2009, 2:13:18 AM (13 years ago)
Author:
charles
Message:

(1.7x) backports for 1.76: #2447 (manpage errors)

Location:
branches/1.7x
Files:
6 edited

Legend:

Unmodified
Added
Removed
  • branches/1.7x/NEWS

    r9115 r9355  
     1=== Transmission 1.76 (2009/09/13) ===
     2==== All Platforms ====
     3  * Fix manpage errors
     4  * Use automake's "quieter builds" rule when available
     5
    16=== Transmission 1.75 (2009/09/13) ===
    27[http://trac.transmissionbt.com/query?milestone=1.75&group=component&groupdesc=1&order=severity All tickets closed by this release]
  • branches/1.7x/cli/transmissioncli.1

    r8710 r9355  
    5959The options are as follows:
    6060.Bl -tag -width Ds
    61 
    6261.It Fl a, Fl -announce Ar announce-url
    6362When creating a new torrent, set its announce URL
    64 
    6563.It Fl b Fl -blocklist
    6664Enable peer blocklists.  Transmission understands the bluetack blocklist file format.
    6765New blocklists can be added by copying them into the config-dir's "blocklists" subdirectory.
    68 
    6966.It Fl B Fl -no-blocklist
    7067Disble blocklists.
    71 
    7268.It Fl c, Fl -comment Ar comment-text
    7369When creating a new torrent, set its comment field
    74 
    7570.It Fl d, -downlimit Ar number
    7671Set the maximum download speed in KB/s
    77 
    7872.It Fl D, -no-downlimit
    7973Don't limit the download speed
    80 
    8174.It Fl er Fl -encryption-required
    8275Encrypt all peer connections.
     
    8578.It Fl et Fl -encryption-tolerated
    8679Prefer unencrypted peer connections.
    87 
    8880.It Fl f, -finish Ar script
    8981Set a script to run when the torrent finishes
    90 
    9182.It Fl g, Fl -config-dir Ar directory
    9283Where to look for configuration files.  This can be used to swap between using the cli, daemon, gtk, and qt clients.
    9384See http://trac.transmissionbt.com/wiki/ConfigFiles for more information.
    94 
    9585.It Fl h, Fl -help
    9686Prints a short usage summary.
    97 
    9887.It Fl i, Fl -info
    9988Shows torrent details and exit
    100 
    10189.It Fl m, Fl -portmap
    10290Enable portmapping via NAT-PMP or UPnP
    103 
    10491.It Fl M, Fl -no-portmap
    10592Disable portmapping
    106 
    10793.It Fl n, Fl -new Ar sourcefile
    10894Create torrent from the specified file or directory
    109 
    11095.It Fl p, -port Ar port
    11196Set the port to listen for incoming peers. (Default: 51413)
    112 
    11397.It Fl r, Fl -private
    11498When creating a new torrent, set its 'private' flag
    115 
    11699.It Fl s, -scrape
    117100Print the current number of seeders and leechers for the specified torrent
    118 
    119101.It Fl t, -tos
    120102Set the peer socket TOS for local router-based traffic shaping.
    121 
    122103.It Fl u, -uplimit Ar number
    123104Set the maximum upload speed in KB/s
    124 
    125105.It Fl U, -no-uplimit
    126106Don't limit the upload speed
    127 
    128107.It Fl v, Fl -verify
    129108Verify the torrent's downloaded data.
    130 
    131109.It Fl w, Fl -download-dir Ar directory
    132110Where to save downloaded data.
    133 
    134111.Sh SIGNALS
    135112In addition to these options, sending
  • branches/1.7x/configure.ac

    r9113 r9355  
    1212AC_SUBST(USERAGENT_PREFIX,[user_agent_prefix])
    1313AC_SUBST(PEERID_PREFIX,[peer_id_prefix])
     14
     15m4_ifdef([AM_SILENT_RULES],[AM_SILENT_RULES([yes])])
    1416
    1517AC_CONFIG_MACRO_DIR([m4])
  • branches/1.7x/daemon/transmission-daemon.1

    r8710 r9355  
    11.Dd July 21, 2008
    22.Dt TRANSMISSION-DAEMON 1
    3 
    43.Sh NAME
    54.Nm transmission-daemon
     
    2928.Op Fl w Ar download-dir
    3029.Ek
    31 
    3230.Sh DESCRIPTION
    3331.Nm
     
    3533via RPC commands from transmission's web interface or
    3634.Xr transmission-remote 1 .
    37 
    3835.Sh OPTIONS
    3936.Bl -tag -width Ds
    40 
    4137.It Fl a Fl -allowed Ar x.x.x.x,...
    4238Allow RPC access to a comma-delimited whitelist of IP addresses.
     
    4440Default: "127.0.0.1"
    4541Example: "127.0.0.*,192.168.1.*"
    46 
    4742.It Fl b Fl -blocklist
    4843Enable peer blocklists.  Transmission understands the bluetack blocklist file format.
    4944New blocklists can be added by copying them into the config-dir's "blocklists" subdirectory.
    50 
    5145.It Fl c Ar directory
    5246Directory to watch for new .torrent files to be added.  As they are added to this directory,
    5347the daemon will load them into Transmission.
    54 
    5548.It Fl C
    5649Do not watch for new .torrent files.
    57 
    5850.It Fl B Fl -no-blocklist
    5951Disble blocklists.
    60 
    6152.It Fl f Fl -foreground
    6253Run in the foreground and print errors to stderr.
    63 
    6454.It Fl g Fl -config-dir Ar directory
    6555Where to look for configuration files.  This can be used to swap between using the cli, daemon, gtk, and qt clients.
    6656See http://trac.transmissionbt.com/wiki/ConfigFiles for more information.
    67 
    68 
    6957.It Fl er Fl -encryption-required
    7058Encrypt all peer connections.
     
    7361.It Fl et Fl -encryption-tolerated
    7462Prefer unencrypted peer connections.
    75 
    7663.It Fl h Fl -help
    7764Print command-line option descriptions.
    78 
    7965.It Fl i Fl -bind-address-ipv4
    8066Listen for IPv4 BitTorrent connections on a specific address. Only one IPv4 listening address is allowed. Default: 0.0.0.0 (All addresses)
     
    8369.It Fl r Fl -rpc-bind-address
    8470Listen for RPC connections on a specific address. This must be an IPv4 address. Only one RPC listening address is allowed. Default: 0.0.0.0 (All addresses)
    85 
    8671.It Fl -paused
    8772Pause all torrents on startup
    88 
    8973.It Fl L Fl -peerlimit-global Ar limit
    9074Overall peer limit. Useful on embedded systems where the default might be unsuitable. Default: 240
    9175.It Fl l Fl -peerlimit-torrent Ar limit
    9276Peer limit per torrent. Useful on embedded systems where the default might be unsuitable. Default: 60
    93 
    9477.It Fl m Fl -portmap
    9578Enable portmapping via NAT-PMP or UPnP
    9679.It Fl M Fl -no-portmap
    9780Disable portmapping
    98 
    9981.It Fl p Fl -port Ar port
    10082Port to open and listen for RPC requests on.  Default: 9091
    101 
    10283.It Fl P, -peerport Ar port
    10384Port to listen for incoming peers on. Default: 51413
    104 
    10585.It Fl t Fl -auth
    10686Require clients to authenticate themselves.
     
    11090.Ar password
    11191are also set.
    112 
    11392.It Fl T Fl -no-auth
    11493Don't require authentication from clients.
    115 
    11694.It Fl u Fl -username Ar username
    11795Used for client authentication.
    118 
    11996.It Fl v Fl -password Ar password
    12097Used for client authentication.
    121 
    12298.It Fl V Fl -version
    12399Show version number and exit
    124 
    125100.It Fl w Fl -download-dir
    126101Where to store downloaded data.
    127 
    128102.El
    129 
    130103.Sh ENVIRONMENT
    131104.Bl -tag -width Fl
     
    133106Sets the default config-dir.
    134107.El
    135 
    136 
    137108.Sh FILES
    138109.Bl -tag -width Ds -compact
     
    145116See http://trac.transmissionbt.com/wiki/ConfigFiles for more information.
    146117.El
    147 
    148 
    149118.Sh AUTHORS
    150119.An -nosplit
     
    154123and
    155124.An Mitchell Livingston .
    156 
    157125.Sh SEE ALSO
    158126.Xr transmissioncli 1 ,
  • branches/1.7x/daemon/transmission-remote.1

    r8961 r9355  
    6767connects to the transmission session at localhost:9091.
    6868Other sessions can be controlled by specifying a different host and/or port.
    69 
    7069.Sh OPTIONS
    7170.Bl -tag -width Ds
    7271.It Fl a Fl -add Ar filenames-or-URLs
    7372Add torrents to transmission.
    74 
    7573.It Fl b Fl -debug
    7674Enable debugging mode.
    77 
    7875.It Fl as Fl -alt-speed
    7976Use the alternate Limits.
    80 
    8177.It Fl AS Fl -no-alt-speed
    8278Don't use the alternate Limits.
    83 
    8479.It Fl asd Fl -alt-speed-downlimit Ar limit
    8580Limit the alternate download speed to
    8681.Ar limit
    8782kilobytes per second.
    88 
    8983.It Fl asu Fl -alt-speed-uplimit Ar limit
    9084Limit the alternate upload speed to
    9185.Ar limit
    9286kilobytes per second.
    93 
    9487.It Fl asc Fl -alt-speed-scheduler
    9588Use the scheduled on/off times.
    96 
    9789.It Fl ASC Fl -no-alt-speed-scheduler
    9890Don't use the scheduled on/off days and times.
    99 
    10091.It Fl -alt-speed-time-begin Ar time
    10192.Ar Time
    10293to start using the alt speed limits (in hhmm).
    103 
    10494.It Fl -alt-speed-time-end Ar time
    10595.Ar Time
    10696to stop using the alt speed limits (in hhmm).
    107 
    10897.It Fl -alt-speed-days Ar days
    10998Set the number of
    11099.Ar days
    111100on which to enable the speed scheduler, using a list such as "2,4-6".
    112 
    113101.It Fl d Fl -downlimit Ar limit
    114102Limit the global download speed to
    115103.Ar limit
    116104kilobytes per second.
    117 
    118105.It Fl D Fl -no-downlimit
    119106Remove the global download limit.
    120 
    121107.It Fl er Fl -encryption-required
    122108Encrypt all peer connections.
     
    125111.It Fl et Fl -encryption-tolerated
    126112Prefer unencrypted peer connections.
    127 
    128113.It Fl f Fl -files
    129114Get a file list for the current torrent(s)
    130 
    131115.It Fl g Fl -get Ar all | file-index | files
    132116Mark file(s) for download.
     
    137121.Ar files
    138122adds multiple files to the download list,
    139 such as "-g1,3-5" to add files #1, #3, #4, and #5 to the download list.
    140 
     123such as "\-g1,3-5" to add files #1, #3, #4, and #5 to the download list.
    141124.It Fl G Fl -no-get Ar all | file-index | files
    142125Mark file(s) for not downloading.
    143 
    144126.It Fl gsr Fl -global-seedratio Ar ratio
    145127All torrents, unless overridden by a per-torrent setting, should seed until a specific
    146128.Ar ratio
    147 
    148129.It Fl GSR Fl -no-global-seedratio
    149130All torrents, unless overridden by a per-torrent setting, should seed regardless of ratio
    150 
    151131.It Fl h Fl -help
    152132Print command-line option descriptions.
    153 
    154133.It Fl i Fl -info Ar id | torrent-hash
    155134Show details of the current torrent(s)
    156 
    157135.It Fl si Fl -session-info
    158136List session information from the server
    159 
    160137.It Fl st Fl -session-stats
    161138List statistical information from the server
    162 
    163139.It Fl l Fl -list
    164140List all torrents
    165 
    166141.It Fl m Fl -portmap
    167142Enable portmapping via NAT-PMP or UPnP
    168143.It Fl M Fl -no-portmap
    169144Disable portmapping
    170 
    171145.It Fl n Fl -auth Ar username:password
    172146Set the
     
    175149.Ar password
    176150for authentication
    177 
    178151.It Fl N Fl -netrc Ar filename
    179152Set the authentication information from a
    180153.Ar netrc file.
    181154See netrc(5) for more information.
    182 
    183155.It Fl o Fl -dht
    184156Enable distributed hash table (DHT).
    185157.It Fl O Fl -no-dht
    186158Disable distribued hash table (DHT).
    187 
    188159.It Fl p Fl -port Ar port
    189160Set the
    190161.Ar port
    191162for use when listening for incoming peer connections
    192 
    193163.It Fl pn Fl -priority-normal Ar all | file-index | files
    194164Mark file(s) as normal priority.
     
    199169.Ar files
    200170sets multiple files' priorities as normal,
    201 such as "-pn1,3-5" to normalize files #1, #3, #4, and #5.
    202 
     171such as "\-pn1,3-5" to normalize files #1, #3, #4, and #5.
    203172.It Fl ph Fl -priority-high Ar all | file-index | files
    204173Mark file(s) as high priority.
    205 
    206174.It Fl pl Fl -priority-low Ar all | file-index | files
    207175Mark file(s) as low priority.
    208 
    209176.It Fl pr Fl -peers Ar number
    210177Set the current torrent(s)' maximum number of peers
    211 
    212178.It Fl gpr Fl -global-peers Ar number
    213179Set the maximum number of peers allowed globally
    214 
    215180.It Fl r Fl -remove
    216181Remove the current torrent(s).  This does not delete the downloaded data.
    217 
    218182.It Fl -remove-and-delete
    219183Remove the current torrent(s) and delete their downloaded data.
    220 
    221184.It Fl -move
    222185Move the current torrents' data from their current locations to the specified directory.
    223 
    224186.It Fl -find
    225187Tell Transmission where to look for the current torrents' data.
    226 
    227188.It Fl sr Fl -seedratio Ar ratio
    228189Let the current torrent(s) seed until a specific
    229190.Ar ratio
    230 
    231191.It Fl SR Fl -no-seedratio
    232192Let the current torrent(s) seed regardless of ratio
    233 
    234193.It Fl srd Fl -seedratio-default
    235194Let the current torrent(s) use the global seedratio settings
    236 
    237195.It Fl s Fl -start
    238196Start the current torrent(s)
    239 
    240197.It Fl S Fl -stop
    241198Stop the current torrent(s) from downloading or seeding
    242 
    243199.It Fl t Fl -torrent Ar all | id | torrent-hash
    244200Set the current torrent(s) for use by subsequent options.
     
    249205.Ar hash .
    250206To set more than one current torrent, join their ids or hashes together in a list,
    251 such as "-t2,4,6-8" to operate on the torrents whose IDs are 2, 4, 6, 7, and 8.
    252 
     207such as "\-t2,4,6-8" to operate on the torrents whose IDs are 2, 4, 6, 7, and 8.
    253208.It Fl u Fl -uplimit Ar limit
    254209Limit the global upload speed to
     
    257212.It Fl U Fl -no-uplimit
    258213Remove the global upload limit.
    259 
    260214.It Fl v Fl -verify
    261215Verify the current torrent(s)
    262 
    263216.It Fl V Fl -version
    264217Show version number and exit
    265 
    266218.It Fl w Fl -download-dir Ar directory
    267219Use
    268220.Ar directory
    269221as the default location for newly added torrents to download files to.
    270 
    271222.It Fl x Fl -pex
    272223Enable peer exchange (PEX).
    273224.It Fl X Fl -no-pex
    274225Disable peer exchange (PEX).
    275 
    276226.It Fl pi Fl -peer-info
    277227List the current torrent's connected peers.
     
    287237.D1 X: Peer was discovered through Peer Exchange (PEX)
    288238.D1 ?: We unchoked this peer, but they're not interested
    289 
    290239.El
    291240.Sh EXAMPLES
    292 
    293241Set download and upload limits to 400 KiB/sec and 60 KiB/sec:
    294242.Bd -literal -offset indent
    295 $ transmission-remote -d400 -u60
    296 $ transmission-remote --downlimit=400 --uplimit=60
    297 .Ed
    298 
     243$ transmission-remote \-d400 \-u60
     244$ transmission-remote \-\-downlimit=400 \-\-uplimit=60
     245.Ed
    299246Set alternate download and upload limits to 100 KiB/sec and 20 KiB/sec:
    300247.Bd -literal -offset indent
    301 $ transmission-remote -asd100 -asu20
    302 $ transmission-remote --alt-speed-downlimit=100 --alt-speed-uplimit=20
    303 .Ed
    304 
     248$ transmission-remote \-asd100 \-asu20
     249$ transmission-remote \-\-alt-speed-downlimit=100 \-\-alt-speed-uplimit=20
     250.Ed
    305251Set the scheduler to use the alternate speed limits on weekdays between 10AM and 11PM
    306252.Bd -literal -offset indent
    307 $ transmission-remote --alt-speed-time-begin=1000
    308 $ transmission-remote --alt-speed-time-end=2300
    309 $ transmission-remote --alt-speed-days=1-5
    310 $ transmission-remote --alt-speed-scheduler
    311 .Ed
    312 
     253$ transmission-remote \-\-alt-speed-time-begin=1000
     254$ transmission-remote \-\-alt-speed-time-end=2300
     255$ transmission-remote \-\-alt-speed-days=1-5
     256$ transmission-remote \-\-alt-speed-scheduler
     257.Ed
    313258List all torrents' IDs and states:
    314259.Bd -literal -offset indent
    315 $ transmission-remote -l
    316 .Ed
    317 
     260$ transmission-remote \-l
     261.Ed
    318262List all torrents from a remote session that requires authentication:
    319263.Bd -literal -offset indent
    320 $ transmission-remote host:9091 --auth=username:password -l
    321 .Ed
    322 
     264$ transmission-remote host:9091 \-\-auth=username:password \-l
     265.Ed
    323266Start all torrents:
    324267.Bd -literal -offset indent
    325 $ transmission-remote -tall --start
    326 .Ed
    327 
     268$ transmission-remote \-tall \-\-start
     269.Ed
    328270Add two torrents:
    329271.Bd -literal -offset indent
    330 $ transmission-remote -a one.torrent two.torrent
    331 .Ed
    332 
     272$ transmission-remote \-a one.torrent two.torrent
     273.Ed
    333274Add all torrents in ~/Desktop:
    334275.Bd -literal -offset indent
    335 $ transmission-remote -a ~/Desktop/*torrent
    336 .Ed
    337 
     276$ transmission-remote \-a ~/Desktop/*torrent
     277.Ed
    338278Get detailed information on the torrent whose ID is '1':
    339279.Bd -literal -offset indent
    340 $ transmission-remote -t1 -i
    341 .Ed
    342 
     280$ transmission-remote \-t1 \-i
     281.Ed
    343282Get a list of a torrent's files:
    344283.Bd -literal -offset indent
    345 $ transmission-remote -t1 -l
    346 .Ed
    347 
     284$ transmission-remote \-t1 \-l
     285.Ed
    348286Download only its second and fourth files:
    349287.Bd -literal -offset indent
    350 $ transmission-remote -t1 -Gall -g2,4
    351 .Ed
    352 
     288$ transmission-remote \-t1 \-Gall \-g2,4
     289.Ed
    353290Set all torrents' first two files' priorities to high:
    354291.Bd -literal -offset indent
    355 $ transmission-remote -tall -ph1,2
    356 .Ed
    357 
     292$ transmission-remote \-tall \-ph1,2
     293.Ed
    358294Set all torrents' files' priorities to normal:
    359295.Bd -literal -offset indent
    360 $ transmission-remote -tall -pnall
    361 .Ed
    362 
     296$ transmission-remote \-tall \-pnall
     297.Ed
    363298.Sh AUTHORS
    364299.An -nosplit
     
    368303and
    369304.An Mitchell Livingston .
    370 
    371305.Sh SEE ALSO
    372306.Xr transmissioncli 1 ,
    373307.Xr transmission-daemon 1 ,
    374308.Xr transmission 1
    375 
    376309.Pp
    377310http://www.transmissionbt.com/
  • branches/1.7x/gtk/transmission.1

    r8710 r9355  
    2020.\" FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
    2121.\" DEALINGS IN THE SOFTWARE.
    22 
    2322.Dd May 20, 2008
    2423.Dt TRANSMISSION-GTK 1
     
    5251Where to look for configuration files.  This can be used to swap between using the cli, daemon, gtk, and qt clients.
    5352See http://trac.transmissionbt.com/wiki/ConfigFiles for more information.
    54 
    5553.El
    5654.Pp
     
    6058.Nm
    6159is already running, the torrents will be added to the running instance.
    62 
    6360.Sh ENVIRONMENT
    6461.Bl -tag -width Fl
     
    6663Sets the default config-dir.
    6764.El
    68 
    6965.Sh FILES
    7066.Bl -tag -width Ds -compact
     
    7672is specified.
    7773.El
    78 
    7974.Sh AUTHORS
    8075.An -nosplit
     
    8681and
    8782.An Mitchell Livingston .
    88 
    8983.Sh SEE ALSO
    9084.Xr transmissioncli 1 ,
Note: See TracChangeset for help on using the changeset viewer.