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

Re: [PATCH] meson: make GIT_HTML_PATH configurable

From
Ben Knoble <ben.knoble@gmail.com>
Date
Nov 6, 2025, 14:08 UTC
Message-ID
<0930DCB8-D545-4043-87F9-4359EA5351D9@gmail.com>
In-Reply-To
<aQxTZNYKKAsmL9Sg@pks.im>
Show 50 quoted lines
> 
> Le 6 nov. 2025 à 02:51, Patrick Steinhardt <ps@pks.im> a écrit :
> 
> On Tue, Nov 04, 2025 at 08:58:29AM -0500, D. Ben Knoble wrote:
>> Makefile-based builds can configure Git's internal HTML_PATH by defining
>> htmldir, which is useful for packagers that put documentation in
>> different locations. Gentoo, for example, uses version-suffixed
>> directories like ${prefix}/share/doc/git-2.51 and puts the HTML
>> documentation in an 'html' subdirectory of the same.
>> 
>> Propagate the same configuration knob to Meson-based builds so that
>> "git --html-path" on such systems can be configured to output the
>> correct directory.
> 
> Makes sense.
> 
>> diff --git a/Documentation/meson.build b/Documentation/meson.build
>> index 9d24f2da54..c00c9fe7f4 100644
>> --- a/Documentation/meson.build
>> +++ b/Documentation/meson.build
> 
> All of the conversions look sensible to me.
> 
>> diff --git a/meson.build b/meson.build
>> index 2b763f7c53..1f95a06edb 100644
>> --- a/meson.build
>> +++ b/meson.build
>> @@ -768,13 +768,18 @@ if test_output_directory == ''
>>   test_output_directory = meson.project_build_root() / 'test-output'
>> endif
>> 
>> +htmldir = get_option('htmldir')
>> +if htmldir == ''
>> +  htmldir = get_option('datadir') / 'doc/git-doc'
>> +endif
> 
> This retains the status quo, good.
> 
>> diff --git a/meson_options.txt b/meson_options.txt
>> index 143dee9237..13d421c067 100644
>> --- a/meson_options.txt
>> +++ b/meson_options.txt
>> @@ -1,6 +1,8 @@
>> # Configuration for Git installation
>> option('perllibdir', type: 'string', value: '',
>>   description: 'Directory to install perl lib to. Defaults to <datadir>/perl5')
>> +option('htmldir', type: 'string', value: '',
>> +  description: 'Directory to install HTML docs to. Defaults to <datadir>/doc/git-doc')
> 
> Tiny nit: let's keep these options ordered lexicographically.
Can do. Shall I send v2, Junio?
> 
> Other than that the patch looks good to me, thanks!
> 
> Patrick
Thank you!
Previous: Patrick SteinhardtNext: Junio C Hamano
Message 6 of 10 in “meson: make GIT_HTML_PATH configurable”
  1. meson: make GIT_HTML_PATH configurableD. Ben Knoble, Nov 4, 2025
  2. Junio C HamanoNov 4, 2025
  3. Ben KnobleNov 4, 2025
  4. Patrick SteinhardtNov 6, 2025
  5. Patrick SteinhardtNov 6, 2025
  6. Ben KnobleNov 6, 2025
  7. Junio C HamanoNov 6, 2025
  8. meson: make GIT_HTML_PATH configurableD. Ben Knoble, Nov 11, 2025
  9. Karthik NayakNov 11, 2025
  10. D. Ben KnobleNov 11, 2025

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.