respond to one item and make another into a bug report

2 files changed, 41 insertions, 25 deletions

diff --git a/doc/bugs/build_in_opensolaris.mdwn b/doc/bugs/build_in_opensolaris.mdwn
new file mode 100644
index 000000000..4e5b92d2d
--- /dev/null
+++ b/doc/bugs/build_in_opensolaris.mdwn
@@ -0,0 +1,33 @@
+I've learned I'm not yet clever enough to get IkiWiki to build in OpenSolaris (as running on a [Joyent Accelerator][ja]). Anyone figured this out already?
+
+I think problem lies mostly, if not entirely, in getting ikiwiki.cgi.c to compile in an OpenSolaris context (this is ikiwiki-2.2):
+
+> <code>$ ikiwiki --setup ~/etc/ikiwiki/ikiwiki-edit.setup  
+> [...]  
+> Error: failed to compile /home/username/domains/domain.tld/cgi-bin/ikiwiki.cgi.c at /opt/local/lib/perl5/site_perl/IkiWiki.pm line 104.
+BEGIN failed--compilation aborted at (eval 3) line 145.</code>
+
+More specifically, 
+
+> <code>$ /usr/sfw/bin/gcc ikiwiki.cgi.c  
+> Undefined               first referenced  
+> symbol                     in file  
+> asprintf                   /var/tmp//cczPaG7R.o  
+> ld: fatal: Symbol referencing errors. No output written to a.out  
+> collect2: ld returned 1 exit status</code>
+
+[ja]: <http://www.joyent.com/accelerator/technical-specifications/>
+
+Thanks, Joey et al., for a really cool tool.
+
+--Mike
+
+> Looks like the ikiwiki wrapper uses asprintf.  glibc has that, and I think some other libc implementations have that, but apparently the Solaris libc does not.  The same problem will come up on other platforms that don't use glibc.  The ikiwiki wrapper needs to either avoid asprintf or use a portable asprintf implementation from somewhere like gnulib. --[[JoshTriplett]]
+
+>> I used asprintf because it was easy, and safe. That is a good reason for
+>> C libraries to support asprintf, IMHO. Note that both linux and *BSD
+>> support asprintf.
+>> 
+>> Of the possible patches to make this more portable, I'd generally prefer
+>> one that uses portable functions (safely), rather than one that includes
+>> an asprintf implementation in ikiwiki. --[[Joey]]
diff --git a/doc/index/discussion.mdwn b/doc/index/discussion.mdwn
index 1e4d2a12b..d08cd9141 100644
--- a/doc/index/discussion.mdwn
+++ b/doc/index/discussion.mdwn
@@ -178,32 +178,15 @@ My best regards,
 
 --[[Paweł|ptecza]]
 
+> This is not new behavior in 2.2 as far as I know. Ikiwiki was always 
+> interpreted "[ [foo bar] ]" as a preprocessor directive, with the
+> whitespace after the first word being the significant bit that
+> distinguishes it from a wikilink. If you want whitespace in a wikilink,
+> you use underscores; there's been a note at the end of [[WikiLink]] about
+> that for some time. --[[Joey]]
+
 ----
 
 # Build in OpenSolaris?
 
-I've learned I'm not yet clever enough to get IkiWiki to build in OpenSolaris (as running on a [Joyent Accelerator][ja]). Anyone figured this out already?
-
-I think problem lies mostly, if not entirely, in getting ikiwiki.cgi.c to compile in an OpenSolaris context (this is ikiwiki-2.2):
-
-> <code>$ ikiwiki --setup ~/etc/ikiwiki/ikiwiki-edit.setup  
-> [...]  
-> Error: failed to compile /home/username/domains/domain.tld/cgi-bin/ikiwiki.cgi.c at /opt/local/lib/perl5/site_perl/IkiWiki.pm line 104.
-BEGIN failed--compilation aborted at (eval 3) line 145.</code>
-
-More specifically, 
-
-> <code>$ /usr/sfw/bin/gcc ikiwiki.cgi.c  
-> Undefined               first referenced  
-> symbol                     in file  
-> asprintf                   /var/tmp//cczPaG7R.o  
-> ld: fatal: Symbol referencing errors. No output written to a.out  
-> collect2: ld returned 1 exit status</code>
-
-[ja]: <http://www.joyent.com/accelerator/technical-specifications/>
-
-Thanks, Joey et al., for a really cool tool.
-
---Mike
-
-> Looks like the ikiwiki wrapper uses asprintf.  glibc has that, and I think some other libc implementations have that, but apparently the Solaris libc does not.  The same problem will come up on other platforms that don't use glibc.  The ikiwiki wrapper needs to either avoid asprintf or use a portable asprintf implementation from somewhere like gnulib. --[[JoshTriplett]]
\ No newline at end of file
+Moved to [[bugs/build_in_opensolaris]] --[[Joey]]