Changeset View
Changeset View
Standalone 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 file paths</title> | ||||
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}/share/bash-completion/completions</filename></entry> | ||||
</row> | </row> | ||||
Done Inline ActionsIt 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> | ||||
<entry><command>fish</command></entry> | |||||
<entry><filename>${PREFIX}/share/fish/completions/${PORTNAME}.fish</filename></entry> | |||||
Done Inline ActionsThere 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… | |||||
</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> |
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.