git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: Suggestion: doc restructuring

From
Johannes Schindelin <johannes.schindelin@gmx.de>
Date
Jul 20, 2008, 11:02 UTC
Message-ID
<alpine.DEB.1.00.0807201257400.3305@eeepc-johanness>
In-Reply-To
<7vk5fhc6qo.fsf@gitster.siamese.dyndns.org>
Hi,
On Sun, 20 Jul 2008, Junio C Hamano wrote:
Show 10 quoted lines
> Johannes Schindelin <Johannes.Schindelin@gmx.de> writes:
> 
> > So what I really would like is this: leave the plumbing pages as they 
> > are, but enhance those pages that users (especially new ones) are 
> > likely to see most often.
> 
> Regarding the original "do we want to ever teach plumbing to new users?" 
> issue, I suspect that, with sufficient enhancement to Porcelain, we 
> might be able to reach a point where end users can work without ever 
> touching a single plumbing command at all.

I just went back to the thread I mentioned earlier, http://thread.gmane.org/gmane.comp.version-control.git/59935/focus=62021 and I did not find where you need plumbing.

> Perhaps move the plumbing documentation to section 3; just like Perl has 
> DBI.3pm and friends there, /usr/share/man/man3/git-cat-file.3git will 
> describe what scripts can do with the command.

But of course! I was wondering where to put it, but understanding plumbing as a sort of library for shell scripts makes sense absolutely!

Ciao, Dscho

Previous: Junio C HamanoNext: Andreas Ericsson
Message 111 of 114 in “Considering teaching plumbing to users harmful”
  1. Johannes SchindelinJul 16, 2008
  2. Jesper EskilsonJul 16, 2008
  3. Johannes SchindelinJul 16, 2008
  4. Jesper EskilsonJul 16, 2008
  5. Johannes SchindelinJul 16, 2008
  6. Avery PennarunJul 16, 2008
  7. Johannes SchindelinJul 16, 2008
  8. Avery PennarunJul 16, 2008
  9. Theodore TsoJul 16, 2008
  10. Daniel BarkalowJul 16, 2008
  11. David KastrupJul 17, 2008
  12. Jakub NarebskiJul 17, 2008
  13. David KastrupJul 17, 2008
  14. Subversion's do-everything-via-copying paradigm ( was RE: Re: Considering teaching plumbing to users harmful)Craig L. Ching, Jul 17, 2008
  15. David KastrupJul 17, 2008
  16. Craig L. ChingJul 17, 2008
  17. Avery PennarunJul 17, 2008
  18. Junio C HamanoJul 17, 2008
  19. Jakub NarebskiJul 17, 2008
  20. Kevin BallardJul 17, 2008
  21. Petr BaudisJul 17, 2008
  22. Kevin BallardJul 17, 2008
  23. Jakub NarebskiJul 17, 2008
  24. Kevin BallardJul 17, 2008
  25. Jakub NarebskiJul 17, 2008
  26. Kevin BallardJul 17, 2008
  27. Kevin BallardJul 17, 2008
  28. David KastrupJul 17, 2008
  29. Robin RosenbergJul 17, 2008
  30. Dmitry PotapovJul 18, 2008
  31. Subversion is actually not so simple (was RE: Considering teaching plumbing to users harmful)Craig L. Ching, Jul 17, 2008
  32. Jakub NarebskiJul 17, 2008
  33. Daniel BarkalowJul 17, 2008
  34. Junio C HamanoJul 16, 2008
  35. Avery PennarunJul 16, 2008
  36. Petr BaudisJul 16, 2008
  37. Avery PennarunJul 16, 2008
  38. Junio C HamanoJul 16, 2008
  39. Avery PennarunJul 16, 2008
  40. Junio C HamanoJul 16, 2008
  41. Avery PennarunJul 16, 2008
  42. Junio C HamanoJul 16, 2008
  43. Theodore TsoJul 16, 2008
  44. Junio C HamanoJul 16, 2008
  45. Sean KelleyJul 16, 2008
  46. Nigel MagnayJul 16, 2008
  47. Stephen SinclairJul 17, 2008
  48. Ping YinJul 18, 2008
  49. Dmitry PotapovJul 16, 2008
  50. Johannes SchindelinJul 16, 2008
  51. Theodore TsoJul 16, 2008
  52. Johannes SchindelinJul 17, 2008
  53. Theodore TsoJul 17, 2008
  54. Craig L. ChingJul 17, 2008
  55. Petr BaudisJul 17, 2008
  56. J. Bruce FieldsJul 17, 2008
  57. david@lang.hmJul 16, 2008
  58. Dmitry PotapovJul 16, 2008
  59. Stephen R. van den BergJul 16, 2008
  60. Nicolas PitreJul 16, 2008
  61. Junio C HamanoJul 16, 2008
  62. Johannes SchindelinJul 16, 2008
  63. Junio C HamanoJul 16, 2008
  64. Johannes SchindelinJul 17, 2008
  65. Junio C HamanoJul 17, 2008
  66. J. Bruce FieldsJul 17, 2008
  67. Karl HasselströmJul 17, 2008
  68. Johannes SchindelinJul 17, 2008
  69. Junio C HamanoJul 17, 2008
  70. Johannes SchindelinJul 17, 2008
  71. Junio C HamanoJul 17, 2008
  72. J. Bruce FieldsJul 18, 2008
  73. Addremove equivalent [was: Re: Considering teaching plumbing to users harmful]Michael J Gruber, Jul 18, 2008
  74. Jay SoffianJul 18, 2008
  75. Johannes SchindelinJul 18, 2008
  76. Junio C HamanoJul 20, 2008
  77. 1/2 builtin-add.c: restructure the code for maintainabilityJunio C Hamano, Jul 20, 2008
  78. 2/2 git-add -a: add all filesJunio C Hamano, Jul 20, 2008
  79. 3/2 git-add -a: testsJunio C Hamano, Jul 20, 2008
  80. TarmiganJul 20, 2008
  81. TarmiganJul 20, 2008
  82. Johannes SchindelinJul 20, 2008
  83. Jay SoffianJul 20, 2008
  84. Junio C HamanoJul 20, 2008
  85. Lars NoschinskiJul 20, 2008
  86. Jeff KingJul 20, 2008
  87. Junio C HamanoJul 21, 2008
  88. Jeff KingJul 21, 2008
  89. Jeff KingJul 21, 2008
  90. Jay SoffianJul 21, 2008
  91. Sverre RabbelierJul 20, 2008
  92. Dmitry PotapovJul 16, 2008
  93. Johannes SchindelinJul 16, 2008
  94. Stephan BeyerJul 16, 2008
  95. Johannes SchindelinJul 16, 2008
  96. Stephan BeyerJul 17, 2008
  97. Peter Valdemar Mørch (Lists)Jul 17, 2008
  98. Dmitry PotapovJul 17, 2008
  99. Theodore TsoJul 17, 2008
  100. Peter Valdemar MørchJul 17, 2008
  101. Theodore TsoJul 17, 2008
  102. Junio C HamanoJul 17, 2008
  103. Andreas EricssonJul 18, 2008
  104. Jeff KingJul 18, 2008
  105. Suggestion: doc restructuring [was: Re: Considering teaching plumbing to users harmful]Michael J Gruber, Jul 18, 2008
  106. Jon LoeligerJul 18, 2008
  107. Craig L. ChingJul 18, 2008
  108. Junio C HamanoJul 18, 2008
  109. Johannes SchindelinJul 19, 2008
  110. Junio C HamanoJul 20, 2008
  111. Johannes SchindelinJul 20, 2008
  112. Andreas EricssonJul 21, 2008
  113. Johannes SchindelinJul 21, 2008
  114. Junio C HamanoJul 21, 2008

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.