# Re: index manipulation quickref 5 messages from 2006-12-12 to 2006-12-12. Participants: Nguyen Thai Ngoc Duy, Junio C Hamano, Santi Béjar, Jakub Narebski. Thread: https://gitlist.dev/t/43167 ## Nguyen Thai Ngoc Duy, 2006-12-12 10:57 Subject: index manipulation quickref Message-ID: URL: https://gitlist.dev/e/fcaeb9bf0612120257p35dc9483ob65eea9ae21b5f7b%40mail.gmail.com ``` Hi, I'm trying to collect all operations related to index from user perspective and corresponding commands. The list may be put to git wiki if people think it can help newbies: update file content to index: git update-index file add a file to index: git add file delete a file from index: git update-index --remove --force-remove (or remove that file in workdir and do git update-index --remove) read a tree to index: git read-tree treeish, git reset treeish read a file from a tree to index: git ls-tree treeish file|git update-index --index-info --stdin copy a file from index to workdir: git checkout-index file refresh index: git update-index --refresh copy entire index to workdir: git checkout-index output a file from index to stdout: ?? (is there a command for this?) list files in index: git ls-files compare index and workdir file listing: git ls-files (with lots of options here) diff between workdir and index: git diff diff between index and a tree: git diff --cached treeish Am I missing any operation here? -- ``` ## Jakub Narebski, 2006-12-12 11:16 Subject: Re: index manipulation quickref Message-ID: URL: https://gitlist.dev/e/elm2ur%243ib%241%40sea.gmane.org In-Reply-To: ``` Nguyen Thai Ngoc Duy wrote: > I'm trying to collect all operations related to index from user > perspective and corresponding commands. The list may be put to git > wiki if people think it can help newbies: > > update file content to index: git update-index file Or "git add file" woth new git. > add a file to index: git add file > delete a file from index: git update-index --remove --force-remove > (or remove that file in workdir and do git update-index --remove) Or "git rm file" (old version did remove only from index, new version is to remove also from working directory if it matches HEAD) > read a tree to index: git read-tree treeish, git reset treeish > read a file from a tree to index: git ls-tree file|git > update-index --index-info --stdin > copy a file from index to workdir: git checkout-index file Or just "git checkout -- file" > refresh index: git update-index --refresh > copy entire index to workdir: git checkout-index Or just "git checkout" > output a file from index to stdout: ?? (is there a command for this?) "git cat-file -p ::" > list files in index: git ls-files > compare index and workdir file listing: > git ls-files (with lots of options here) > diff between workdir and index: git diff > diff between index and a tree: git diff --cached diff between workdir and tree: git diff -- Jakub Narebski Warsaw, Poland ShadeHawk on #git ``` ## Santi Béjar, 2006-12-12 11:28 Subject: Re: index manipulation quickref Message-ID: <8aa486160612120328x2ab64c78v6a6d5bc2a64caf26@mail.gmail.com> URL: https://gitlist.dev/e/8aa486160612120328x2ab64c78v6a6d5bc2a64caf26%40mail.gmail.com In-Reply-To: ``` On 12/12/06, Nguyen Thai Ngoc Duy wrote: > Hi, > > I'm trying to collect all operations related to index from user > perspective and corresponding commands. The list may be put to git > wiki if people think it can help newbies: Cool. But for "index-newbies" not "git-newbies" :) We could add (if exists) the porcelain-ish equivalent as: update file content to index: git update-index file git add file (the development version) add a file to index: git update-index --add file git add file delete a file from index: git update-index --remove [--force-remove] file git rm file read a tree to index: git read-tree treeish git reset commit-ish # It changes also the HEAD read a file from a tree to index: git ls-tree treeish file | git update-index --index-info --stdin N/A copy a file from index to workdir: git checkout-index file git checkout file refresh index: git update-index --refresh git status # It does more things copy entire index to workdir: git checkout-index git checkout -f output a file from index to stdout: git cat-file blob :file (or :n:file, where n=0,1,2,3 are the unmerged stage) ?? list files in index: git ls-files ?? compare index and workdir file listing: git ls-files (with lots of options here) git status? diff between workdir and index: git diff-files git diff diff between index and a tree: git diff-index --cached treeish git diff --cached treeish ``` ## Junio C Hamano, 2006-12-12 18:18 Subject: Re: index manipulation quickref Message-ID: <7vac1tvuyr.fsf@assigned-by-dhcp.cox.net> URL: https://gitlist.dev/e/7vac1tvuyr.fsf%40assigned-by-dhcp.cox.net In-Reply-To: ``` "Nguyen Thai Ngoc Duy" writes: > I'm trying to collect all operations related to index from user > perspective and corresponding commands. The list may be put to git > wiki if people think it can help newbies: I think this goes in the wrong direction. For "newbies" the Porcelain-ish set is supposed to be enough and if there is something missing that they need to do update-index command itself or a pipeline that involves update-index to achieve common tasks, we should enhance Porcelain-ish that captures the pattern. I think quick-ref for Porcelain writers would not hurt, but they have manuals. ``` ## Nguyen Thai Ngoc Duy, 2006-12-12 21:32 Subject: Re: index manipulation quickref Message-ID: URL: https://gitlist.dev/e/fcaeb9bf0612121332m51dea9day2f18c80b94ff4d5d%40mail.gmail.com In-Reply-To: <7vac1tvuyr.fsf@assigned-by-dhcp.cox.net> ``` On 12/13/06, Junio C Hamano wrote: > I think this goes in the wrong direction. For "newbies" the > Porcelain-ish set is supposed to be enough and if there is > something missing that they need to do update-index command > itself or a pipeline that involves update-index to achieve > common tasks, we should enhance Porcelain-ish that captures the > pattern. It is supposed to be porcelain command only. I figure what operation a user may need when manipulating index, then find the corresponding porcelain command. As you can see, we have porcelain commands for most of operations. The missing piece is reset a file in index (and maybe "git cat-file ::file" -- it's too cryptic). Hopefully "git reset -- file" will be implemented soon. -- ```