what are plumbing and porcelain

what are plumbing and porcelain

[bill lam]

Sorry for this idiot question, but I really don't know what they are
and why it is necessary to distinguish between them.

-- 
regards,
====================================================
GPG key 1024D/4434BAB3 2008-08-24
gpg --keyserver subkeys.pgp.net --recv-keys 4434BAB3
唐詩318 李白  清平調三首之二
    一枝紅豔露凝香  雲雨巫山枉斷腸  借問漢宮誰得似  可憐飛燕倚新妝

Re: what are plumbing and porcelain

[Boyd Stephen Smith Jr.]

[-- Attachment #1: Type: text/plain, Size: 1325 bytes --]

On Tuesday 20 January 2009, bill lam <cbill.lam@gmail.com> wrote 
about 'what are plumbing and porcelain':
>Sorry for this idiot question, but I really don't know what they are
>and why it is necessary to distinguish between them.

"plumbing" are the commands that do low-level operations.  Generally, 
end-users won't have to use them much, if at all, but they 
are "fundamental" operations, upon which git is built.  It's a term also 
used in other project some, with a similar meaning.

"porcelain" is a cute name for the end-user operations.  They "cover" the 
plumbing to make it look and act "pretty".  While some may be less useful 
to some users, they all are high-level operations that depend on the 
plumbing.

It's important to distinguish between them because we don't want the 
plumbing to get needlessly complex.  They should be single-purpose 
commands and their options should be utilitarian in nature.  Also, 
porcelain is meant to be used interactively, not in scripts, so the output 
or behavior might change a bit--but that is still kept to a minimum.
-- 
Boyd Stephen Smith Jr.                     ,= ,-_-. =. 
bss@iguanasuicide.net                     ((_/)o o(\_))
ICQ: 514984 YM/AIM: DaTwinkDaddy           `-'(. .)`-' 
http://iguanasuicide.net/                      \_/     

[-- Attachment #2: This is a digitally signed message part. --]
[-- Type: application/pgp-signature, Size: 197 bytes --]

Re: what are plumbing and porcelain

[bill lam]

On Tue, 20 Jan 2009, Boyd Stephen Smith Jr. wrote:
> "plumbing" are the commands that do low-level operations.  Generally, 
> end-users won't have to use them much, if at all, but they 

I can see now gitk should probably be porcelain. But how about
commands such as git add or git rebase used with either the -i switch
on or off?

-- 
regards,
====================================================
GPG key 1024D/4434BAB3 2008-08-24
gpg --keyserver subkeys.pgp.net --recv-keys 4434BAB3
唐詩299 李商隱  寄令狐郎中
    嵩雲秦樹久離居  雙鯉迢迢一紙筆  休問梁園舊賓客  茂陵秋雨病相如

Re: what are plumbing and porcelain

[Boyd Stephen Smith Jr.]

[-- Attachment #1: Type: text/plain, Size: 1172 bytes --]

On Wednesday 21 January 2009, bill lam <cbill.lam@gmail.com> wrote 
about 'Re: what are plumbing and porcelain':
>On Tue, 20 Jan 2009, Boyd Stephen Smith Jr. wrote:
>> "plumbing" are the commands that do low-level operations.  Generally,
>> end-users won't have to use them much, if at all, but they
>
>I can see now gitk should probably be porcelain. But how about
>commands such as git add or git rebase used with either the -i switch
>on or off?

If you have git installed, "man git" should contain separate lists of 
porcelain and plumbing.  If not, the documentation is available in the git 
repository, under Documentation/.  Porcelain: cmds-mainporcelain.txt, 
cmds-ancillarymanipulators.txt, cmds-ancillaryinterrogators.txt, and 
cmds-foreignscminterface.txt.  Plumbing: cmds-plumbingmanipulators.txt, 
cmds-plumbinginterrogators.txt, cmds-synchingrepositories.txt, 
cmds-synchelpers.txt, and cmds-purehelpers.txt
-- 
Boyd Stephen Smith Jr.                     ,= ,-_-. =. 
bss@iguanasuicide.net                     ((_/)o o(\_))
ICQ: 514984 YM/AIM: DaTwinkDaddy           `-'(. .)`-' 
http://iguanasuicide.net/                      \_/     

[-- Attachment #2: This is a digitally signed message part. --]
[-- Type: application/pgp-signature, Size: 197 bytes --]

Re: what are plumbing and porcelain

[bill lam]

Thanks for bringing my attention to that.

-- 
regards,
====================================================
GPG key 1024D/4434BAB3 2008-08-24
gpg --keyserver subkeys.pgp.net --recv-keys 4434BAB3
唐詩306 鄭畋  馬嵬坡
    玄宗回馬楊妃死  雲雨難忘日月新  終是聖明天子事  景陽宮井又何人