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

Re: [Outreachy] internship contribution

From
Đoàn Trần Công Danh <congdanhqx@gmail.com>
Date
Oct 12, 2022, 06:45 UTC
Message-ID
<Y0Zig4XUePPhMaA3@danh.dev>
In-Reply-To
<xmqqleplmz3n.fsf@gitster.g>
On 2022-10-11 21:42:52-0700, Junio C Hamano <gitster@pobox.com> wrote:
Show 38 quoted lines
> NSENGIYUMVA WILBERFORCE <nsengiyumvawilberforce@gmail.com> writes:
> 
> > Hi team, I am reading through "My first contribution"
> > when I run make all doc, I get the following;
> >
> > SUBDIR git-gui
> >     SUBDIR gitk-git
> >     SUBDIR templates
> > make -C Documentation all
> > make[1]: Entering directory '/mnt/c/Users/USER/documents/git/Documentation'
> > make[2]: Entering directory '/mnt/c/Users/USER/documents/git'
> > make[2]: 'GIT-VERSION-FILE' is up to date.
> > make[2]: Leaving directory '/mnt/c/Users/USER/documents/git'
> >     XMLTO git-version.1
> > /bin/sh: 1: xmlto: not found
> > make[1]: *** [Makefile:355: git-version.1] Error 127
> > make[1]: Leaving directory '/mnt/c/Users/USER/documents/git/Documentation'
> > make: *** [Makefile:2720: doc] Error 2
> >
> > How should I go about it?
> 
> Googling "xmlto: not found", the first result is
> 
>     https://command-not-found.com/xmlto
> 
> The page lists how to get and install it for various platforms, and
> WSL/Windows should be included there.
> 
> I believe "My first contribution" recommends to first read the
> top-level INSTALL before continuing (and if not, it should be
> updated to).  Simpler things first---building and installing the
> vanilla source code without any of your changes should be simpler
> and you should become confident in doing that, before you start
> modifying anything. Otherwise, when you encounter a problem, you
> would not be able to tell if you broke it with your change, or your
> basic set-up is not complete (e.g. missing necessary tools like
> xmlto) and unable to build and install from even vanilla set of
> sources.

Maybe he is on Windows and using Git-for-Windows SDK? I'm not sure what's included there, but I can imagine that man-pages is useless on Windows, they would prefer html docs instead. Perhaps, they want:

	make all && make -C Documentation html
When building only html, xmlto is not necessary to be installed.
-- 
Danh
Previous: Junio C HamanoNext: NSENGIYUMVA WILBERFORCE
Message 12 of 17 in “[Outreachy] internship contribution”
  1. NSENGIYUMVA WILBERFORCEOct 9, 2022
  2. Christian CouderOct 10, 2022
  3. NSENGIYUMVA WILBERFORCEOct 10, 2022
  4. Christian CouderOct 10, 2022
  5. Derrick StoleeOct 10, 2022
  6. Luna JernbergOct 10, 2022
  7. NSENGIYUMVA WILBERFORCEOct 10, 2022
  8. Derrick StoleeOct 10, 2022
  9. NSENGIYUMVA WILBERFORCEOct 11, 2022
  10. NSENGIYUMVA WILBERFORCEOct 12, 2022
  11. Junio C HamanoOct 12, 2022
  12. Đoàn Trần Công DanhOct 12, 2022
  13. NSENGIYUMVA WILBERFORCEOct 12, 2022
  14. Christian CouderOct 12, 2022
  15. Đoàn Trần Công DanhOct 12, 2022
  16. NSENGIYUMVA WILBERFORCEOct 12, 2022
  17. Christian CouderOct 13, 2022

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.