Download raw body.
Use .Xo/.Xc in the man pages
diff f0680473a7db1e5941bffdc2ab5f80ddec209122 075e6bd0fb4c64302a774c3ef4bd2187cbe1b4b2 commit - f0680473a7db1e5941bffdc2ab5f80ddec209122 commit + 075e6bd0fb4c64302a774c3ef4bd2187cbe1b4b2 blob - d629445e1b234fb60ebb1aa76195a8d2283e029a blob + 65a62a169432829c5bf7f9231226468273be39ad --- got/got.1 +++ got/got.1 @@ -63,7 +63,14 @@ The commands for are as follows: .Bl -tag -width checkout .Tg im -.It Cm import Oo Fl b Ar branch Oc Oo Fl I Ar pattern Oc Oo Fl m Ar message Oc Oo Fl r Ar repository-path Oc Ar directory +.It Xo +.Cm import +.Op Fl b Ar branch +.Op Fl I Ar pattern +.Op Fl m Ar message +.Op Fl r Ar repository-path +.Ar directory +.Xc .Dl Pq alias: Cm im Create an initial commit in a repository from the file hierarchy within the specified @@ -124,7 +131,14 @@ If not specified, assume the repository is located at working directory. .El .Tg cl -.It Cm clone Oo Fl almqv Oc Oo Fl b Ar branch Oc Oo Fl R Ar reference Oc Ar repository-URL Op Ar directory +.It Xo +.Cm clone +.Op Fl almqv +.Op Fl b Ar branch +.Op Fl R Ar reference +.Ar repository-URL +.Op Ar directory +.Xc .Dl Pq alias: Cm cl Clone a Git repository at the specified .Ar repository-URL @@ -307,7 +321,14 @@ Multiple -v options increase the verbosity. The maximum is 3. .El .Tg fe -.It Cm fetch Oo Fl adlqtvX Oc Oo Fl b Ar branch Oc Oo Fl R Ar reference Oc Oo Fl r Ar repository-path Oc Op Ar remote-repository +.It Xo +.Cm fetch +.Op Fl adlqtvX +.Op Fl b Ar branch +.Op Fl R Ar reference +.Op Fl r Ar repository-path +.Op Ar remote-repository +.Xc .Dl Pq alias: Cm fe Fetch new changes from a remote repository. If no @@ -480,7 +501,15 @@ will generally be stored in pack files and may be remo and Git's garbage collector. .El .Tg co -.It Cm checkout Oo Fl Eq Oc Oo Fl b Ar branch Oc Oo Fl c Ar commit Oc Oo Fl p Ar path-prefix Oc Ar repository-path Op Ar work-tree-path +.It Xo +.Cm checkout +.Op Fl Eq +.Op Fl b Ar branch +.Op Fl c Ar commit +.Op Fl p Ar path-prefix +.Ar repository-path +.Op Ar work-tree-path +.Xc .Dl Pq alias: Cm co Copy files from a repository into a new work tree. Show the status of each affected file, using the following status codes: @@ -545,7 +574,13 @@ will be checked out. Silence progress output. .El .Tg up -.It Cm update Oo Fl q Oc Oo Fl b Ar branch Oc Oo Fl c Ar commit Oc Op Ar path ... +.It Xo +.Cm update +.Op Fl q +.Op Fl b Ar branch +.Op Fl c Ar commit +.Op Ar path ... +.Xc .Dl Pq alias: Cm up Update an existing work tree to a different .Ar commit . @@ -643,7 +678,13 @@ branch will be used. Silence progress output. .El .Tg st -.It Cm status Oo Fl I Oc Oo Fl S Ar status-codes Oc Oo Fl s Ar status-codes Oc Op Ar path ... +.It Xo +.Cm status +.Op Fl I +.Op Fl S Ar status-codes +.Op Fl s Ar status-codes +.Op Ar path ... +.Xc .Dl Pq alias: Cm st Show the current modification status of files in a work tree, using the following status codes: @@ -745,7 +786,17 @@ does not support negated ignore patterns prefixed with and gives no special significance to the location of path component separators, .Dq / , in a pattern. -.It Cm log Oo Fl bPpRs Oc Oo Fl C Ar number Oc Oo Fl c Ar commit Oc Oo Fl l Ar N Oc Oo Fl r Ar repository-path Oc Oo Fl S Ar search-pattern Oc Oo Fl x Ar commit Oc Op Ar path +.It Xo +.Cm log +.Op Fl bPpRs +.Op Fl C Ar number +.Op Fl c Ar commit +.Op Fl l Ar N +.Op Fl r Ar repository-path +.Op Fl S Ar search-pattern +.Op Fl x Ar commit +.Op Ar path +.Xc Display history of a repository. If a .Ar path @@ -847,7 +898,14 @@ This option has no effect if the specified is never traversed. .El .Tg di -.It Cm diff Oo Fl aPsw Oc Oo Fl C Ar number Oc Oo Fl c Ar commit Oc Oo Fl r Ar repository-path Oc Op Ar object1 Ar object2 | Ar path ... +.It Xo +.Cm diff +.Op Fl aPsw +.Op Fl C Ar number +.Op Fl c Ar commit +.Op Fl r Ar repository-path +.Op Ar object1 Ar object2 | Ar path ... +.Xc .Dl Pq alias: Cm di When invoked within a work tree without any arguments, display all local changes in the work tree. @@ -925,7 +983,12 @@ is invoked in a work tree. Ignore whitespace-only changes. .El .Tg bl -.It Cm blame Oo Fl c Ar commit Oc Oo Fl r Ar repository-path Oc Ar path +.It Xo +.Cm blame +.Op Fl c Ar commit +.Op Fl r Ar repository-path +.Ar path +.Xc .Dl Pq alias: Cm bl Display line-by-line history of a file at the specified path. .Pp @@ -949,7 +1012,13 @@ If this directory is a work tree, use the repository path associated with this work tree. .El .Tg tr -.It Cm tree Oo Fl iR Oc Oo Fl c Ar commit Oc Oo Fl r Ar repository-path Oc Op Ar path +.It Xo +.Cm tree +.Op Fl iR +.Op Fl c Ar commit +.Op Fl r Ar repository-path +.Op Ar path +.Xc .Dl Pq alias: Cm tr Display a listing of files and directories at the specified directory path in the repository. @@ -993,7 +1062,14 @@ If this directory is a .Nm work tree, use the repository path associated with this work tree. .El -.It Cm ref Oo Fl dlt Oc Oo Fl c Ar object Oc Oo Fl r Ar repository-path Oc Oo Fl s Ar reference Oc Op Ar name +.It Xo +.Cm ref +.Op Fl dlt +.Op Fl c Ar object +.Op Fl r Ar repository-path +.Op Fl s Ar reference +.Op Ar name +.Xc Manage references in a repository. .Pp References may be listed, created, deleted, and changed. @@ -1068,7 +1144,14 @@ Use of this option requires the option to be used as well. .El .Tg br -.It Cm branch Oo Fl lnt Oc Oo Fl c Ar commit Oc Oo Fl d Ar name Oc Oo Fl r Ar repository-path Oc Op Ar name +.It Xo +.Cm branch +.Op Fl lnt +.Op Fl c Ar commit +.Op Fl d Ar name +.Op Fl r Ar repository-path +.Op Ar name +.Xc .Dl Pq alias: Cm br Create, list, or delete branches. .Pp @@ -1172,7 +1255,15 @@ Use of this option requires the .Fl l option to be used as well. .El -.It Cm tag Oo Fl lVv Oc Oo Fl c Ar commit Oc Oo Fl m Ar message Oc Oo Fl r Ar repository-path Oc Oo Fl s Ar signer-id Oc Ar name +.It Xo +.Cm tag +.Op Fl lVv +.Op Fl c Ar commit +.Op Fl m Ar message +.Op Fl r Ar repository-path +.Op Fl s Ar signer-id +.Ar name +.Xc Manage tags in a repository. .Pp Tags are managed via references which live in the @@ -1276,7 +1367,11 @@ If a tag must be deleted, the command may be used to delete a tag's reference. This should only be done if the tag has not already been copied to another repository. -.It Cm add Oo Fl IR Oc Ar path ... +.It Xo +.Cm add +.Op Fl IR +.Ar path ... +.Xc Schedule unversioned files in a work tree for addition to the repository in the next commit. By default, files which match a @@ -1300,7 +1395,12 @@ will refuse to run if a specified is a directory. .El .Tg rm -.It Cm remove Oo Fl fkR Oc Oo Fl s Ar status-codes Oc Ar path ... +.It Xo +.Cm remove +.Op Fl fkR +.Op Fl s Ar status-codes +.Ar path ... +.Xc .Dl Pq alias: Cm rm Remove versioned files from a work tree and schedule them for deletion from the repository in the next commit. @@ -1337,7 +1437,13 @@ option) .El .El .Tg pa -.It Cm patch Oo Fl nR Oc Oo Fl c Ar commit Oc Oo Fl p Ar strip-count Oc Op Ar patchfile +.It Xo +.Cm patch +.Op Fl nR +.Op Fl c Ar commit +.Op Fl p Ar strip-count +.Op Ar patchfile +.Xc .Dl Pq alias: Cm pa Apply changes from .Ar patchfile @@ -1458,7 +1564,12 @@ will be recognized and stripped automatically. Reverse the patch before applying it. .El .Tg rv -.It Cm revert Oo Fl pR Oc Oo Fl F Ar response-script Oc Ar path ... +.It Xo +.Cm revert +.Op Fl pR +.Op Fl F Ar response-script +.Ar path ... +.Xc .Dl Pq alias: Cm rv Revert any local changes in files at the specified paths in a work tree. File contents will be overwritten with those contained in the @@ -1509,7 +1620,14 @@ will refuse to run if a specified is a directory. .El .Tg ci -.It Cm commit Oo Fl NS Oc Oo Fl A Ar author Oc Oo Fl F Ar path Oc Oo Fl m Ar message Oc Op Ar path ... +.It Xo +.Cm commit +.Op Fl NS +.Op Fl A Ar author +.Op Fl F Ar path +.Op Fl m Ar message +.Op Ar path ... +.Xc .Dl Pq alias: Cm ci Create a new commit in the repository from changes in a work tree and use this commit as the new base commit for the work tree. @@ -1644,7 +1762,15 @@ If a path is found to be out of date, must be used first in order to merge local changes with changes made in the repository. .Tg se -.It Cm send Oo Fl afqTv Oc Oo Fl b Ar branch Oc Oo Fl d Ar branch Oc Oo Fl r Ar repository-path Oc Oo Fl t Ar tag Oc Op Ar remote-repository +.It Xo +.Cm send +.Op Fl afqTv +.Op Fl b Ar branch +.Op Fl d Ar branch +.Op Fl r Ar repository-path +.Op Fl t Ar tag +.Op Ar remote-repository +.Xc .Dl Pq alias: Cm se Send new changes to a remote repository. If no @@ -1917,7 +2043,11 @@ to a single base commit with If any relevant files already contain merge conflicts, these conflicts must be resolved first. .Tg rb -.It Cm rebase Oo Fl aclX Oc Op Ar branch +.It Xo +.Cm rebase +.Op Fl aclX +.Op Ar branch +.Xc .Dl Pq alias: Cm rb Rebase commits on the specified .Ar branch @@ -2118,7 +2248,12 @@ None of the other options can be used together with .Fl X . .El .Tg he -.It Cm histedit Oo Fl aceflmX Oc Oo Fl F Ar histedit-script Oc Op Ar branch +.It Xo +.Cm histedit +.Op Fl aceflmX +.Op Fl F Ar histedit-script +.Op Ar branch +.Xc .Dl Pq alias: Cm he Edit commit history between the work tree's current base commit and the tip commit of the work tree's current branch. @@ -2431,7 +2566,11 @@ committed with or reverted with .Cm got revert . .Tg mg -.It Cm merge Oo Fl acn Oc Op Ar branch +.It Xo +.Cm merge +.Op Fl acn +.Op Ar branch +.Xc .Dl Pq alias: Cm mg Create a merge commit based on the current branch of the work tree and the specified @@ -2557,7 +2696,12 @@ Alternatively, the merge may be aborted with .Cm got merge -a . .El .Tg sg -.It Cm stage Oo Fl lpS Oc Oo Fl F Ar response-script Oc Op Ar path ... +.It Xo +.Cm stage +.Op Fl lpS +.Op Fl F Ar response-script +.Op Ar path ... +.Xc .Dl Pq alias: Cm sg Stage local changes for inclusion in the next commit. If no @@ -2673,7 +2817,12 @@ before it can be updated with .Cm got update , and may then be staged again if necessary. .Tg ug -.It Cm unstage Oo Fl p Oc Oo Fl F Ar response-script Oc Op Ar path ... +.It Xo +.Cm unstage +.Op Fl p +.Op Fl F Ar response-script +.Op Ar path ... +.Xc .Dl Pq alias: Cm ug Merge staged changes back into the work tree and put affected paths back into non-staged status. @@ -2720,7 +2869,13 @@ If a file is staged in modified status, individual pat staged file content can be unstaged. Files staged in added or deleted status may only be unstaged in their entirety. .El -.It Cm cat Oo Fl P Oc Oo Fl c Ar commit Oc Oo Fl r Ar repository-path Oc Ar arg ... +.It Xo +.Cm cat +.Op Fl P +.Op Fl c Ar commit +.Op Fl r Ar repository-path +.Ar arg ... +.Xc Parse and print contents of objects to standard output in a line-based text format. Content of commit, tree, and tag objects is printed in a way similar blob - 0f970bf8e42b6329fb4b1718ff50f3d637eb442f blob + 80901f0e63c615048925c439ab54ddeb1f70b743 --- gotadmin/gotadmin.1 +++ gotadmin/gotadmin.1 @@ -64,7 +64,7 @@ the command must be used to populate the empty repository before .Cm got checkout can be used. -.It Cm info Oo Fl r Ar repository-path Oc +.It Cm info Op Fl r Ar repository-path Display information about a repository. This includes some configuration settings from .Xr got.conf 5 , @@ -83,7 +83,13 @@ If this directory is a .Xr got 1 work tree, use the repository path associated with this work tree. .El -.It Cm pack Oo Fl aq Oc Oo Fl r Ar repository-path Oc Oo Fl x Ar reference Oc Op Ar reference ... +.It Xo +.Cm pack +.Op Fl aq +.Op Fl r Ar repository-path +.Op Fl x Ar reference +.Op Ar reference ... +.Xc Generate a new pack file and a corresponding pack file index. By default, add any loose objects which are reachable via any references to the generated pack file. @@ -164,7 +170,11 @@ The filename of the corresponding pack index is equiva that it ends in .Pa .idx . .Tg ls -.It Cm listpack Oo Fl hs Oc Ar packfile-path +.It Xo +.Cm listpack +.Op Fl hs +.Ar packfile-path +.Xc .Dl Pq alias: Cm ls List the contents of the pack file at .Ar packfile-path . @@ -201,7 +211,11 @@ This includes the total number of objects stored in th and a break-down of the number of objects per object type. .El .Tg cl -.It Cm cleanup Oo Fl anpq Oc Op Fl r Ar repository-path +.It Xo +.Cm cleanup +.Op Fl anpq +.Op Fl r Ar repository-path +.Xc .Dl Pq alias: Cm cl Purge unreferenced loose objects from the repository and display the amount of disk space which has been freed as a result. blob - cbd5233dd61d780f245c5bcb24d95b030a5a7676 blob + 65405972315ce384c286567d1765d330d8d9a13f --- tog/tog.1 +++ tog/tog.1 @@ -111,7 +111,13 @@ The commands for .Nm are as follows: .Bl -tag -width blame -.It Cm log Oo Fl b Oc Oo Fl c Ar commit Oc Oo Fl r Ar repository-path Oc Op Ar path +.It Xo +.Cm log +.Op Fl b +.Op Fl c Ar commit +.Op Fl r Ar repository-path +.Op Ar path +.Xc Display history of a repository. If a .Ar path @@ -251,7 +257,14 @@ If this directory is a .Xr got 1 work tree, use the repository path associated with this work tree. .El -.It Cm diff Oo Fl aw Oc Oo Fl C Ar number Oc Oo Fl r Ar repository-path Oc Ar object1 Ar object2 +.It Xo +.Cm diff +.Op Fl aw +.Op Fl C Ar number +.Op Fl r Ar repository-path +.Ar object1 +.Ar object2 +.Xc Display the differences between two objects in the repository. Treat each of the two arguments as a reference, a tag name, or an object ID SHA1 hash, and display differences between the corresponding objects. @@ -365,7 +378,12 @@ work tree, use the repository path associated with thi .It Fl w Ignore whitespace-only changes. .El -.It Cm blame Oo Fl c Ar commit Oc Oo Fl r Ar repository-path Oc Ar path +.It Xo +.Cm blame +.Op Fl c Ar commit +.Op Fl r Ar repository-path +.Ar path +.Xc Display line-by-line history of a file at the specified path. .Pp The key bindings for @@ -459,7 +477,12 @@ If this directory is a .Xr got 1 work tree, use the repository path associated with this work tree. .El -.It Cm tree Oo Fl c Ar commit Oc Oo Fl r Ar repository-path Oc Op Ar path +.It Xo +.Cm tree +.Op Fl c Ar commit +.Op Fl r Ar repository-path +.Op Ar path +.Xc Display the repository tree. If a .Ar path @@ -548,7 +571,7 @@ If this directory is a .Xr got 1 work tree, use the repository path associated with this work tree. .El -.It Cm ref Oo Fl r Ar repository-path Oc +.It Cm ref Op Fl r Ar repository-path Display references in the repository. .Pp The key bindings for
Use .Xo/.Xc in the man pages