Differential D16697 Diff 46605 en_US.ISO8859-1/books/porters-handbook/special/chapter.xml

Changeset View

Standalone View

en_US.ISO8859-1/books/porters-handbook/special/chapter.xml

Show First 20 Lines • Show All 5,826 Lines • ▼ Show 20 Lines	<para>Many modern shells (including bash, tcsh, and zsh) support
have created them themselves.</para>		have created them themselves.</para>

<para>When available, completion files should always be		<para>When available, completion files should always be
installed. It is not necessary to make an option for it.		installed. It is not necessary to make an option for it.
If an option is used, though, always enable it in		If an option is used, though, always enable it in
<varname>OPTIONS_DEFAULT</varname>.</para>		<varname>OPTIONS_DEFAULT</varname>.</para>

<table frame="none" xml:id="shell-completion-paths">		<table frame="none" xml:id="shell-completion-paths">
<title>Shell completion file paths</title>		<title>Shell completion of file paths</title>
		matUnsubmitted Done Inline Actions If you want to use `of`, it needs to be written `Path of shell completion files` or something similar. I would just keep this as it was. mat: If you want to use `of`, it needs to be written `Path of shell completion files` or something…

<tgroup cols="2">		<tgroup cols="2">
<tbody>		<tbody>
<row>		<row>
<entry><command>bash</command></entry>		<entry><command>bash</command></entry>
<entry><filename>${PREFIX}/etc/bash_completion.d</filename></entry>		<entry><filename>${PREFIX}/etc/bash_completion.d</filename> or <filename>${PREFIX}/share/bash-completion/completions</filename></entry>
		matUnsubmitted Done Inline Actions There should only be one directory here, so that committers do not choose randomly where to put the files. Looking at the bash_completion code, it looks like `etc/bash_completion.d` is for legacy scripts, and `share/bash-completion/completions` is for recent scripts. mat: There should only be one directory here, so that committers do not choose randomly where to…
		<entry>(any unique file names in one of these folders)</entry>
		matUnsubmitted Done Inline Actions It would be preferable to say something specific, or to not say anything. mat: It would be preferable to say something specific, or to not say anything.
</row>		</row>

<row>		<row>
		<entry><command>fish</command></entry>
		<entry><filename>${PREFIX}/share/fish/completions/${PORTNAME}.fish</filename></entry>
		</row>

		<row>
<entry><command>zsh</command></entry>		<entry><command>zsh</command></entry>
<entry><filename>${PREFIX}/share/zsh/site-functions</filename></entry>		<entry><filename>${PREFIX}/share/zsh/site-functions/_${PORTNAME}</filename></entry>
</row>		</row>
</tbody>		</tbody>
</tgroup>		</tgroup>
</table>		</table>

<para>Do not register any dependencies on the shells		<para>Do not register any dependencies on the shells
themselves.</para>		themselves.</para>
</sect1>		</sect1>
</chapter>		</chapter>