{"thread":{"id":"17279","subject":"what are plumbing and porcelain","startedAt":"2009-01-21T05:27:41Z","lastAt":"2009-01-21T07:23:54Z","messageCount":5,"participants":["bill lam","Boyd Stephen Smith Jr."],"isPatch":false,"patchVersion":null,"patchTotal":null},"messages":[{"id":"101345","messageId":"20090121052741.GC6970@b2j","threadId":"17279","inReplyTo":null,"subject":"what are plumbing and porcelain","fromName":"bill lam","fromEmail":"cbill.lam@gmail.com","sentAt":"2009-01-21T05:27:41Z","receivedAt":"2009-01-21T05:27:41Z","isPatch":false,"sender":{"key":"cbill.lam@gmail.com","avatar":null},"body":"Sorry for this idiot question, but I really don't know what they are\nand why it is necessary to distinguish between them.\n\n-- \nregards,\n====================================================\nGPG key 1024D/4434BAB3 2008-08-24\ngpg --keyserver subkeys.pgp.net --recv-keys 4434BAB3\n唐詩318 李白  清平調三首之二\n    一枝紅豔露凝香  雲雨巫山枉斷腸  借問漢宮誰得似  可憐飛燕倚新妝\n"},{"id":"101346","messageId":"200901202350.15011.bss@iguanasuicide.net","threadId":"17279","inReplyTo":"20090121052741.GC6970@b2j","subject":"Re: what are plumbing and porcelain","fromName":"Boyd Stephen Smith Jr.","fromEmail":"bss@iguanasuicide.net","sentAt":"2009-01-21T05:50:10Z","receivedAt":"2009-01-21T05:50:10Z","isPatch":false,"sender":{"key":"bss@iguanasuicide.net","avatar":"https://gravatar.com/avatar/84b95eeff194b816c1568b1339e63e4b229825298664a9037b9f1ec713ead1e3?d=mp&s=160"},"body":"On Tuesday 20 January 2009, bill lam <cbill.lam@gmail.com> wrote \nabout 'what are plumbing and porcelain':\n>Sorry for this idiot question, but I really don't know what they are\n>and why it is necessary to distinguish between them.\n\n\"plumbing\" are the commands that do low-level operations.  Generally, \nend-users won't have to use them much, if at all, but they \nare \"fundamental\" operations, upon which git is built.  It's a term also \nused in other project some, with a similar meaning.\n\n\"porcelain\" is a cute name for the end-user operations.  They \"cover\" the \nplumbing to make it look and act \"pretty\".  While some may be less useful \nto some users, they all are high-level operations that depend on the \nplumbing.\n\nIt's important to distinguish between them because we don't want the \nplumbing to get needlessly complex.  They should be single-purpose \ncommands and their options should be utilitarian in nature.  Also, \nporcelain is meant to be used interactively, not in scripts, so the output \nor behavior might change a bit--but that is still kept to a minimum.\n-- \nBoyd Stephen Smith Jr.                     ,= ,-_-. =. \nbss@iguanasuicide.net                     ((_/)o o(\\_))\nICQ: 514984 YM/AIM: DaTwinkDaddy           `-'(. .)`-' \nhttp://iguanasuicide.net/                      \\_/     \n"},{"id":"101347","messageId":"20090121060726.GE6970@b2j","threadId":"17279","inReplyTo":"200901202350.15011.bss@iguanasuicide.net","subject":"Re: what are plumbing and porcelain","fromName":"bill lam","fromEmail":"cbill.lam@gmail.com","sentAt":"2009-01-21T06:07:26Z","receivedAt":"2009-01-21T06:07:26Z","isPatch":false,"sender":{"key":"cbill.lam@gmail.com","avatar":null},"body":"On Tue, 20 Jan 2009, Boyd Stephen Smith Jr. wrote:\n> \"plumbing\" are the commands that do low-level operations.  Generally, \n> end-users won't have to use them much, if at all, but they \n\nI can see now gitk should probably be porcelain. But how about\ncommands such as git add or git rebase used with either the -i switch\non or off?\n\n-- \nregards,\n====================================================\nGPG key 1024D/4434BAB3 2008-08-24\ngpg --keyserver subkeys.pgp.net --recv-keys 4434BAB3\n唐詩299 李商隱  寄令狐郎中\n    嵩雲秦樹久離居  雙鯉迢迢一紙筆  休問梁園舊賓客  茂陵秋雨病相如\n"},{"id":"101348","messageId":"200901210051.21663.bss@iguanasuicide.net","threadId":"17279","inReplyTo":"20090121060726.GE6970@b2j","subject":"Re: what are plumbing and porcelain","fromName":"Boyd Stephen Smith Jr.","fromEmail":"bss@iguanasuicide.net","sentAt":"2009-01-21T06:51:15Z","receivedAt":"2009-01-21T06:51:15Z","isPatch":false,"sender":{"key":"bss@iguanasuicide.net","avatar":"https://gravatar.com/avatar/84b95eeff194b816c1568b1339e63e4b229825298664a9037b9f1ec713ead1e3?d=mp&s=160"},"body":"On Wednesday 21 January 2009, bill lam <cbill.lam@gmail.com> wrote \nabout 'Re: what are plumbing and porcelain':\n>On Tue, 20 Jan 2009, Boyd Stephen Smith Jr. wrote:\n>> \"plumbing\" are the commands that do low-level operations.  Generally,\n>> end-users won't have to use them much, if at all, but they\n>\n>I can see now gitk should probably be porcelain. But how about\n>commands such as git add or git rebase used with either the -i switch\n>on or off?\n\nIf you have git installed, \"man git\" should contain separate lists of \nporcelain and plumbing.  If not, the documentation is available in the git \nrepository, under Documentation/.  Porcelain: cmds-mainporcelain.txt, \ncmds-ancillarymanipulators.txt, cmds-ancillaryinterrogators.txt, and \ncmds-foreignscminterface.txt.  Plumbing: cmds-plumbingmanipulators.txt, \ncmds-plumbinginterrogators.txt, cmds-synchingrepositories.txt, \ncmds-synchelpers.txt, and cmds-purehelpers.txt\n-- \nBoyd Stephen Smith Jr.                     ,= ,-_-. =. \nbss@iguanasuicide.net                     ((_/)o o(\\_))\nICQ: 514984 YM/AIM: DaTwinkDaddy           `-'(. .)`-' \nhttp://iguanasuicide.net/                      \\_/     \n"},{"id":"101349","messageId":"20090121072354.GF6970@b2j","threadId":"17279","inReplyTo":"200901210051.21663.bss@iguanasuicide.net","subject":"Re: what are plumbing and porcelain","fromName":"bill lam","fromEmail":"cbill.lam@gmail.com","sentAt":"2009-01-21T07:23:54Z","receivedAt":"2009-01-21T07:23:54Z","isPatch":false,"sender":{"key":"cbill.lam@gmail.com","avatar":null},"body":"Thanks for bringing my attention to that.\n\n-- \nregards,\n====================================================\nGPG key 1024D/4434BAB3 2008-08-24\ngpg --keyserver subkeys.pgp.net --recv-keys 4434BAB3\n唐詩306 鄭畋  馬嵬坡\n    玄宗回馬楊妃死  雲雨難忘日月新  終是聖明天子事  景陽宮井又何人\n"}]}