From 9c5fe7d9669d9256179f8d284357e14ea0d8bf92 Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Tue, 8 Oct 2013 23:49:44 -0400 Subject: [PATCH] Update the man page --- docs/brasero.1 | 110 ++++++++++++++++++++++++++++++++++++--------------------- 1 file changed, 70 insertions(+), 40 deletions(-) diff --git a/docs/brasero.1 b/docs/brasero.1 index e7bffb0..8bae046 100644 --- a/docs/brasero.1 +++ b/docs/brasero.1 @@ -1,6 +1,6 @@ -.TH BRASERO 1 "January 11, 2009" "GNOME" +.TH BRASERO "1" "April 2011" "GNOME" .SH NAME -brasero \- Simple and easy to use CD/DVD burning application for the Gnome Desktop +brasero \- Simple and easy to use CD/DVD burning application for the GNOME Desktop .SH SYNOPSIS .B brasero .RI [ options ] @@ -9,57 +9,87 @@ brasero \- Simple and easy to use CD/DVD burning application for the Gnome Deskt .RI ... .br .SH DESCRIPTION -This manual page documents briefly the -.B brasero -command. -.PP -\fBBrasero\fP is a disc burning application. It is designed to be simple and easy to use. -It allows to create data CD/DVD, audio CD, to copy CD/DVD and to burn images. It has some nices features, such as a song, image and video previewer. It can also search for files (thanks to beagle) and display a playlist and its contents. +\fBBrasero\fP is an easy-to-use application for burning CD-R/Ws and DVD-R/Ws. +With Brasero you can create data, audio, or video CDs, DVDs, and SVCDs. You can +copy existing disks, use image files, or create new projects. Brasero includes +tools such as a media previewer, integrity checker and a cover creator. .SH OPTIONS -This program follows the usual GNU command line syntax, with long options starting with two dashes (`-'). A summary of options is included below. -For a complete description, see the Info files. +The following options are supported: +.SS "Help Options:" +.TP +\fB\-h\fR, \fB\-\-help\fR +Show help options +.TP +\fB\-\-help\-all\fR +Show all help options + +.SS "Application Options:" +.TP +\fB\-p\fR, \fB\-\-project\fR=\fIPROJECT\fR +Open the specified project +.TP +\fB\-l\fR, \fB\-\-playlist\fR=\fIPLAYLIST\fR +Open the specified playlist as an audio project +.TP +\fB\-\-device\fR=\fIDEVICE\fR PATH +Set the drive to be used for burning +.TP +\fB\-\-image\-file\fR +Create an image file instead of burning +.TP +\fB\-a\fR, \fB\-\-audio\fR +Open an audio project adding the URIs given on the command line +.TP +\fB\-d\fR, \fB\-\-data\fR +Open a data project adding the URIs given on the command line +.TP +\fB\-c\fR, \fB\-\-copy\fR=\fIPATH\fR TO DEVICE +Copy a disc .TP -.B \-p, \-\-project=PROJECT -Open the specified project. +\fB\-j\fR, \fB\-\-cover\fR=\fIPATH\fR TO COVER +Cover to use .TP -.B \-a, \-\-audio -Open an empty audio project. +\fB\-o\fR, \fB\-\-video\fR +Open a video project adding the URIs given on the command line .TP -.B \-d, \-\-data -Open an empty data project. +\fB\-i\fR, \fB\-\-image\fR=\fIPATH\fR TO IMAGE +URI of an image file to burn (autodetected) .TP -.B \-c, \-\-copy=PATH -Copy a disc. +\fB\-e\fR, \fB\-\-empty\fR +Force Brasero to display the project selection page .TP -.B \-j, \-\-cover=PATH -Cover to use. +\fB\-b\fR, \fB\-\-blank\fR=\fIPATH\fR TO DEVICE +Open the blank disc dialog .TP -.B \-o, \-\-video -Open a video project adding the URIs given on the command line. +\fB\-k\fR, \fB\-\-check\fR=\fIPATH\fR TO DEVICE +Open the check disc dialog .TP -.B \-i, \-\-image=PATH -Uri of an image file or a cue file to be burnt (autodetected). +\fB\-n\fR, \fB\-\-ncb\fR +Burn the contents of the burn:// URI .TP -.B \-e, \-\-empty -Force brasero to display the project selection page. +\fB\-\-immediately\fR +Start burning immediately .TP -.B \-b, \-\-blank -Open the blank disc dialog. +\fB\-\-no\-existing\-session\fR +Don't connect to an already\-running instance .TP -.B \-k, \-\-check -Open the check disc dialog. +\fB\-r\fR, \fB\-\-burn\-and\-remove\-project\fR=\fIPATH\fR +Burn the specified project and remove it (mainly useful for integration with +other applications) .TP -.B \-n, \-\-ncb -Open a data project with the contents of burn:/// URI. +\fB\-x\fR, \fB\-\-transient\-for\fR +The XID of the parent window .TP -.B \-r, \-\-burn-and-remove-project=PATH -Burn the specified project and REMOVE it. +\fB\-\-display\fR=\fIDISPLAY\fR +X display to use +.SS "Debugging Options:" .TP -.B \-\-display=DISPLAY -X display to use. +\fB\-\-brasero\-media\-debug\fR +Display debug messages for Brasero media library .TP -.B \-?, \-\-help -Show summary of options. +\fB\-g\fR, \fB\-\-brasero\-burn\-debug\fR +Display debug messages for Brasero burn library +.SH BUGS +Please report any \fBbrasero\fP bugs you find to https://bugzilla.gnome.org. .SH AUTHOR -Brasero manual page was written by Philippe Rouquier - and Luis Medinas . +Brasero\'s manual page was written by Jeremy Bicha . -- 1.8.3.1