Sat Jun 11 20:19:37 2016 UTC ()
Removed strawman TODO items from the documentation.


(rillig)
diff -r1.6 -r1.7 pkgsrc/doc/guide/files/tools.xml
cvs diff -r1.6 -r1.7 pkgsrc/doc/guide/files/tools.xml (expand / switch to unified diff)

--- pkgsrc/doc/guide/files/tools.xml 2011/10/30 22:08:17 1.6
+++ pkgsrc/doc/guide/files/tools.xml 2016/06/11 20:19:36 1.7
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1<!-- $NetBSD: tools.xml,v 1.6 2011/10/30 22:08:17 wiz Exp $ --> 1<!-- $NetBSD: tools.xml,v 1.7 2016/06/11 20:19:36 rillig Exp $ -->
2 2
3<chapter id="tools"> 3<chapter id="tools">
4<title>Tools needed for building or running</title> 4<title>Tools needed for building or running</title>
5 5
6<para>The <varname>USE_TOOLS</varname> definition is used both internally 6<para>The <varname>USE_TOOLS</varname> definition is used both internally
7by pkgsrc and also for individual packages to define what commands 7by pkgsrc and also for individual packages to define what commands
8are needed for building a package (like <varname>BUILD_DEPENDS</varname>) 8are needed for building a package (like <varname>BUILD_DEPENDS</varname>)
9or for later run-time of an installed packaged (such as 9or for later run-time of an installed packaged (such as
10<varname>DEPENDS</varname>). 10<varname>DEPENDS</varname>).
11If the native system provides an adequate tool, then in many cases, a pkgsrc 11If the native system provides an adequate tool, then in many cases, a pkgsrc
12package will not be used.</para> 12package will not be used.</para>
13 13
14<para>When building a package, the replacement tools are 14<para>When building a package, the replacement tools are
@@ -80,46 +80,14 @@ the name of the common tools. For exampl @@ -80,46 +80,14 @@ the name of the common tools. For exampl
80 80
81<programlisting> 81<programlisting>
82.if exists(/usr/bin/bzcat) 82.if exists(/usr/bin/bzcat)
83TOOLS_PLATFORM.bzcat?= /usr/bin/bzcat 83TOOLS_PLATFORM.bzcat?= /usr/bin/bzcat
84.elif exists(/usr/bin/bzip2) 84.elif exists(/usr/bin/bzip2)
85TOOLS_PLATFORM.bzcat?= /usr/bin/bzip2 -cd 85TOOLS_PLATFORM.bzcat?= /usr/bin/bzip2 -cd
86.endif 86.endif
87 87
88TOOLS_PLATFORM.true?= true # shell builtin 88TOOLS_PLATFORM.true?= true # shell builtin
89</programlisting> 89</programlisting>
90 90
91</sect1> 91</sect1>
92 92
93<sect1 id="tools.questions"> 
94<title>Questions regarding the tools</title> 
95 
96<qandaset> 
97<qandaentry id="tools.new"> 
98 
99 <question><para>How do I add a new tool?</para></question> 
100 
101 <answer><para>TODO</para></answer> 
102 
103</qandaentry> 
104<qandaentry id="tools.listall"> 
105 
106 <question><para>How do I get a list of all available 
107 tools?</para></question> 
108 
109 <answer><para>TODO</para></answer> 
110 
111</qandaentry> 
112<qandaentry id="tools.used"> 
113 
114 <question><para>How can I get a list of all the tools that a 
115 package is using while being built? I want to know whether it 
116 uses sed or not.</para></question> 
117 
118 <answer><para>Currently, you can't. (TODO: But I want to be able 
119 to do it.)</para></answer> 
120 
121</qandaentry> 
122 
123</qandaset> 
124</sect1> 
125</chapter> 93</chapter>