{"thread":{"id":"7563","subject":"[PATCH 4/4] Add doc for 'branch'.","startedAt":"2007-04-07T21:36:47Z","lastAt":"2007-04-11T09:34:03Z","messageCount":6,"participants":["Yann Dirson","Catalin Marinas"],"isPatch":true,"patchVersion":1,"patchTotal":4},"messages":[{"id":"38863","messageId":"20070407213557.13698.21486.stgit@gandelf.nowhere.earth","threadId":"7563","inReplyTo":null,"subject":"[PATCH 0/4] StGIT documentation updates","fromName":"Yann Dirson","fromEmail":"ydirson@altern.org","sentAt":"2007-04-07T21:36:47Z","receivedAt":"2007-04-07T21:36:47Z","isPatch":true,"sender":{"key":"ydirson@altern.org","avatar":"https://avatars.githubusercontent.com/u/1190950?v=4"},"body":"This adds a couple of new manpages, and fixes a couple of small doc\nissues.\n\n-- \nYann Dirson    <ydirson@altern.org> |\nDebian-related: <dirson@debian.org> |   Support Debian GNU/Linux:\n                                    |  Freedom, Power, Stability, Gratis\n     http://ydirson.free.fr/        | Check <http://www.debian.org/>\n"},{"id":"38866","messageId":"20070407213653.13698.31672.stgit@gandelf.nowhere.earth","threadId":"7563","inReplyTo":"20070407213557.13698.21486.stgit@gandelf.nowhere.earth","subject":"[PATCH 1/4] Fix typo in help string.","fromName":"Yann Dirson","fromEmail":"ydirson@altern.org","sentAt":"2007-04-07T21:36:53Z","receivedAt":"2007-04-07T21:36:53Z","isPatch":true,"sender":{"key":"ydirson@altern.org","avatar":"https://avatars.githubusercontent.com/u/1190950?v=4"},"body":"\n\n\nSigned-off-by: Yann Dirson <ydirson@altern.org>\n---\n\n stgit/commands/init.py |    4 ++--\n 1 files changed, 2 insertions(+), 2 deletions(-)\n\ndiff --git a/stgit/commands/init.py b/stgit/commands/init.py\nindex df2235f..46562d0 100644\n--- a/stgit/commands/init.py\n+++ b/stgit/commands/init.py\n@@ -28,8 +28,8 @@ help = 'initialise the current branch for use with StGIT'\n usage = \"\"\"%prog [options]\n \n Initialise the current GIT branch to be used as an StGIT stack. Note\n-that the you must already be in a GIT repository and .git/HEAD must\n-point to a valid file in refs/heads/.\"\"\"\n+that you must already be in a GIT repository and .git/HEAD must point\n+to a valid file in refs/heads/.\"\"\"\n \n options = []\n \n"},{"id":"38865","messageId":"20070407213658.13698.44552.stgit@gandelf.nowhere.earth","threadId":"7563","inReplyTo":"20070407213557.13698.21486.stgit@gandelf.nowhere.earth","subject":"[PATCH 2/4] Don't use section 7 for main manpage.","fromName":"Yann Dirson","fromEmail":"ydirson@altern.org","sentAt":"2007-04-07T21:36:58Z","receivedAt":"2007-04-07T21:36:58Z","isPatch":true,"sender":{"key":"ydirson@altern.org","avatar":"https://avatars.githubusercontent.com/u/1190950?v=4"},"body":"\n\n\nSigned-off-by: Yann Dirson <ydirson@altern.org>\n---\n\n Documentation/COMMAND-TEMPLATE.txt |    2 +-\n Documentation/stg-cp.txt           |    2 +-\n Documentation/stg-new.txt          |    2 +-\n Documentation/stg.txt              |    2 +-\n 4 files changed, 4 insertions(+), 4 deletions(-)\n\ndiff --git a/Documentation/COMMAND-TEMPLATE.txt b/Documentation/COMMAND-TEMPLATE.txt\nindex 5d8a1a9..e49a44d 100644\n--- a/Documentation/COMMAND-TEMPLATE.txt\n+++ b/Documentation/COMMAND-TEMPLATE.txt\n@@ -38,4 +38,4 @@ GIT CONFIGURATION VARIABLES\n \n StGIT\n -----\n-Part of the StGIT suite - see gitlink:stg[7].\n+Part of the StGIT suite - see gitlink:stg[1].\ndiff --git a/Documentation/stg-cp.txt b/Documentation/stg-cp.txt\nindex 723d811..d28c619 100644\n--- a/Documentation/stg-cp.txt\n+++ b/Documentation/stg-cp.txt\n@@ -57,4 +57,4 @@ FUTURE OPTIONS\n \n StGIT\n -----\n-Part of the StGIT suite - see gitlink:stg[7].\n+Part of the StGIT suite - see gitlink:stg[1].\ndiff --git a/Documentation/stg-new.txt b/Documentation/stg-new.txt\nindex 698816b..5775559 100644\n--- a/Documentation/stg-new.txt\n+++ b/Documentation/stg-new.txt\n@@ -112,4 +112,4 @@ GIT CONFIGURATION VARIABLES\n \n StGIT\n -----\n-Part of the StGIT suite - see gitlink:stg[7].\n+Part of the StGIT suite - see gitlink:stg[1].\ndiff --git a/Documentation/stg.txt b/Documentation/stg.txt\nindex 7d92356..47934a5 100644\n--- a/Documentation/stg.txt\n+++ b/Documentation/stg.txt\n@@ -1,4 +1,4 @@\n-stg(7)\n+stg(1)\n ======\n Yann Dirson <ydirson@altern.org>\n v0.12.1, February 2007\n"},{"id":"38867","messageId":"20070407213703.13698.16716.stgit@gandelf.nowhere.earth","threadId":"7563","inReplyTo":"20070407213557.13698.21486.stgit@gandelf.nowhere.earth","subject":"[PATCH 3/4] Add doc for 'clone' and 'init'.","fromName":"Yann Dirson","fromEmail":"ydirson@altern.org","sentAt":"2007-04-07T21:37:03Z","receivedAt":"2007-04-07T21:37:03Z","isPatch":true,"sender":{"key":"ydirson@altern.org","avatar":"https://avatars.githubusercontent.com/u/1190950?v=4"},"body":"\n\n\nSigned-off-by: Yann Dirson <ydirson@altern.org>\n---\n\n Documentation/stg-clone.txt |   36 ++++++++++++++++++++++++++++++++++++\n Documentation/stg-init.txt  |   33 +++++++++++++++++++++++++++++++++\n 2 files changed, 69 insertions(+), 0 deletions(-)\n\ndiff --git a/Documentation/stg-clone.txt b/Documentation/stg-clone.txt\nnew file mode 100644\nindex 0000000..73c0d92\n--- /dev/null\n+++ b/Documentation/stg-clone.txt\n@@ -0,0 +1,36 @@\n+stg-clone(1)\n+==========\n+Yann Dirson <ydirson@altern.org>\n+v0.12.1, April 2007\n+\n+NAME\n+----\n+stg-clone - stgdesc:clone[]\n+\n+SYNOPSIS\n+--------\n+stg clone [OPTIONS] <repository> <dir>\n+\n+DESCRIPTION\n+-----------\n+\n+Clone a GIT <repository> into the local <dir> (using\n+gitlink:git-clone[1]) and initialise the resulting \"master\" branch as\n+a patch stack.\n+\n+This operation is for example suitable to start working using the\n+\"tracking branch\" workflow (see gitlink:stg[1]).  Other means to setup\n+an StGIT stack are stgdesc:init[] and the '--create' and '--clone'\n+commands of stgdesc:branch[].\n+\n+The target directory named by <dir> will be created by this command,\n+and must not exist beforehand.\n+\n+OPTIONS\n+-------\n+\n+No specific options.\n+\n+StGIT\n+-----\n+Part of the StGIT suite - see gitlink:stg[1].\ndiff --git a/Documentation/stg-init.txt b/Documentation/stg-init.txt\nnew file mode 100644\nindex 0000000..33fd387\n--- /dev/null\n+++ b/Documentation/stg-init.txt\n@@ -0,0 +1,33 @@\n+stg-init(1)\n+==========\n+Yann Dirson <ydirson@altern.org>\n+v0.12.1, April 2007\n+\n+NAME\n+----\n+stg-init - stgdesc:init[]\n+\n+SYNOPSIS\n+--------\n+stg init [OPTIONS]\n+\n+DESCRIPTION\n+-----------\n+\n+Initialise the current GIT branch to be used as an StGIT stack.  You\n+must already be in a GIT repository and .git/HEAD must point to a\n+valid file in refs/heads/.\n+\n+This operation is for example suitable to start working using the\n+\"development branch\" workflow (see gitlink:stg[1]).  Other means to setup\n+an StGIT stack are stgdesc:clone[] and the '--create' and '--clone'\n+commands of stgdesc:branch[].\n+\n+OPTIONS\n+-------\n+\n+No specific options.\n+\n+StGIT\n+-----\n+Part of the StGIT suite - see gitlink:stg[1].\n"},{"id":"38860","messageId":"20070407213708.13698.28332.stgit@gandelf.nowhere.earth","threadId":"7563","inReplyTo":"20070407213557.13698.21486.stgit@gandelf.nowhere.earth","subject":"[PATCH 4/4] Add doc for 'branch'.","fromName":"Yann Dirson","fromEmail":"ydirson@altern.org","sentAt":"2007-04-07T21:37:08Z","receivedAt":"2007-04-07T21:37:08Z","isPatch":true,"sender":{"key":"ydirson@altern.org","avatar":"https://avatars.githubusercontent.com/u/1190950?v=4"},"body":"\n\n\nSigned-off-by: Yann Dirson <ydirson@altern.org>\n---\n\n Documentation/stg-branch.txt |  127 ++++++++++++++++++++++++++++++++++++++++++\n 1 files changed, 127 insertions(+), 0 deletions(-)\n\ndiff --git a/Documentation/stg-branch.txt b/Documentation/stg-branch.txt\nnew file mode 100644\nindex 0000000..53f333b\n--- /dev/null\n+++ b/Documentation/stg-branch.txt\n@@ -0,0 +1,127 @@\n+stg-branch(1)\n+=============\n+Yann Dirson <ydirson@altern.org>\n+v0.12.1, April 2007\n+\n+NAME\n+----\n+stg-branch - stgdesc:branch[]\n+\n+SYNOPSIS\n+--------\n+stg branch\n+\n+stg branch <branch>\n+\n+stg branch --list\n+\n+stg branch --create <newstack> [<commit-id>]\n+\n+stg branch --clone [<newstack>]\n+\n+stg branch --rename <oldname> <newname>\n+\n+stg branch --protect [<branch>]\n+\n+stg branch --unprotect [<branch>]\n+\n+stg branch --delete [--force] <branch>\n+\n+stg branch --convert\n+\n+DESCRIPTION\n+-----------\n+\n+Assorted operations on branches.\n+\n+no command, no argument::\n+\tDisplay the name of the current branch.\n+\n+no command, one argument::\n+\tSwitch to the named <branch>.\n+\n+--list::\n+-l::\n+\tDisplay the list of branches in the current repository,\n+\tsuffixed by the branch description if any, and optionally\n+\tprefixed by the letter flags 's' if the branch is an StGIT\n+\tstack, and 'p' if the StGIT stack is protected.  The current\n+\tbranch is shown with a leading \">\" character.\n+\n+--create::\n+-c::\n+\tCreate a new StGIT stack based at the specified commit, or at\n+\tthe current HEAD if not specified.  The repository HEAD is\n+\tswitched to the new stack.\n++\n+StGIT will try to detect the branch off which the new stack is forked,\n+as well as the remote repository from which that parent branch is\n+taken (if any), so running stgdesc:pull[] will effectively pull new\n+commits from the correct branch.  It will warn if it cannot guess the\n+parent branch (eg. if you do not specify a branch name as\n+<commit-id>).\n+\n+--clone::\n+\tClone the current stack, under the name <newstack> if\n+\tspecified, or using the current stack's name suffixed by a\n+\ttimestamp.\n++\n+The description of the new stack is set to tell it is a clone of the\n+current stack.  The parent information of the new stack is copied from\n+the current stack.\n++\n+Cloning a GIT branch that is not an StGIT stack is similar to creating\n+a new stack off the current branch.\n+\n+--rename::\n+-r::\n+\tRename the stack named <oldname> to <newname>.\n+\n+--protect::\n+-p::\n+\tProtect the named stack or the current one, preventing\n+\tfurther StGIT operations from modifying this stack.\n+\n+--unprotect::\n+-u::\n+\tRemove a \"protected\" flag previously set with '--protect'.\n+\n+--delete::\n+\tDelete the named <branch>.  If there are any patches left in\n+\tthe series, StGIT will refuse to delete it, unless '--force'\n+\tis specified.\n++\n+A protected branch cannot be deleted, it must be unprotected first\n+(see above).\n++\n+When the current branch is deleted, the repository HEAD is switched to\n+the \"master\" branch if it exists.\n++\n+Branch \"master\" is treated specially (see bug #8732), in that only the\n+StGIT metadata are removed, the GIT branch itself is not destroyed.\n+\n+--convert::\n+\tSwitch current stack between old and new format.\n+\n+OPTIONS\n+-------\n+\n+--force::\n+\tForce a delete when the series is not empty.\n+\n+FILES\n+-----\n+\n+\t$GIT_DIR/patches/<branch>/description\n+\t$GIT_DIR/patches/<branch>/protected\n+\n+GIT CONFIGURATION VARIABLES\n+---------------------------\n+\n+\tbranch.<branchname>.remote\n+\tbranch.<branchname>.merge\n+\tbranch.<branchname>.stgit.parentbranch\n+\n+StGIT\n+-----\n+Part of the StGIT suite - see gitlink:stg[1].\n"},{"id":"39087","messageId":"b0943d9e0704110234qc23ef41ma0bb4eaac714c320@mail.gmail.com","threadId":"7563","inReplyTo":"20070407213658.13698.44552.stgit@gandelf.nowhere.earth","subject":"Re: [PATCH 2/4] Don't use section 7 for main manpage.","fromName":"Catalin Marinas","fromEmail":"catalin.marinas@gmail.com","sentAt":"2007-04-11T09:34:03Z","receivedAt":"2007-04-11T09:34:03Z","isPatch":true,"sender":{"key":"catalin.marinas@gmail.com","avatar":null},"body":"On 07/04/07, Yann Dirson <ydirson@altern.org> wrote:\n> --- a/Documentation/stg.txt\n> +++ b/Documentation/stg.txt\n> @@ -1,4 +1,4 @@\n> -stg(7)\n> +stg(1)\n>  ======\n\nIn error, I added commit 5906924135f886527c1e947d100073067783eaa2 that\nwas reverting this hunk. My reason was to be able to install the man\npages and the Makefile was still looking for stg.7. I'll revert my\ncommit tonight and change the Makefile.\n\n-- \nCatalin\n"}]}