Permalink
Browse files

tutorial: update the explanation of osconf stuff (use config.mak)

  • Loading branch information...
1 parent 999def1 commit 0da630ef9fcfe210e2eff9e3e195b369834b0b35 @ec429 committed Oct 8, 2012
Showing with 2 additions and 2 deletions.
  1. +2 −2 tutorial.htm
View
4 tutorial.htm
@@ -31,8 +31,8 @@
</div><!--#irc-->
<div id="start">
<h2>Getting Started with quIRC</h2>
-<p>Assuming your distributor hasn&apos;t packaged quIRC, the first thing you will need to do is compile it. After downloading the source tarball (or cloning the <tt>git</tt> repository) run <tt>make; sudo make install</tt>. This should compile quIRC and install it under <tt>/usr/local</tt>; to install somewhere else (eg. if <tt>/usr/local</tt> is not in your <tt>$PATH</tt>), you will need to change the definition of <tt>PREFIX</tt> in the <tt>Makefile</tt>. One possible problem at this stage is that your libc may not support asynchronous DNS lookups (<tt>getaddrinfo_a()</tt>), in which case you will need to edit <tt>osconf.h</tt>, changing <tt>ASYNCH_NL</tt> from 1 to 0, and remove <tt>-lanl</tt> from the <tt>OPTLIBS</tt> definition in the <tt>Makefile</tt>. Also, if your C compiler is not <tt>gcc</tt>, you will need to change <tt>CC</tt> (and probably also <tt>CFLAGS</tt> and <tt>OPTFLAGS</tt>) in the Makefile.</p>
-<p>If all of this sounds complicated, and you are running Linux on x86, you can just download the binary tarball (though you will still need to <tt>sudo make install</tt>). Alternatively, OpenSUSE and SLE users can use the package from <a href="https://build.opensuse.org/package/show?package=quirc&project=server%3Airc">the openSUSE Build Service</a>.</p>
+<p>Assuming your distributor hasn&apos;t packaged quIRC, the first thing you will need to do is compile it. After downloading the source tarball (or cloning the <tt>git</tt> repository) run <tt>make; sudo make install</tt>. This should compile quIRC and install it under <tt>/usr/local</tt>; to install somewhere else (eg. if <tt>/usr/local</tt> is not in your <tt>$PATH</tt>), you will need to change the definition of <tt>PREFIX</tt> in the <tt>Makefile</tt>. One possible problem at this stage is that your libc may not support asynchronous DNS lookups (<tt>getaddrinfo_a()</tt>), in which case you will need to edit <tt>config.mak</tt> (if it's not present, copy the stock version from <tt>dist/</tt>), uncommenting the two lines under &quot;<tt># uncomment if your libc does not support getaddrinfo_a</tt>&quot;. Similarly, if your libc produces errors with <tt>intmax_t</tt> (eg. musl libc with gcc), uncomment the <tt>config.mak</tt> line under &quot;<tt># uncomment if you encounter errors with intmax_t and %jd</tt>&quot;. Also, if your C compiler is not <tt>gcc</tt>, you will need to change <tt>CC</tt> (and probably also <tt>CFLAGS</tt> and <tt>OPTFLAGS</tt>) in the Makefile. Finally, note that if you cloned the repository, the Makefile is actually split into two parts, <tt>Makefile</tt> and <tt>distMakefile</tt>, and most of these variables are defined in the latter.</p>
+<p>If all of this sounds complicated, and you are running Linux on x86, you can just download the binary tarball (though you will still need to <tt>sudo make install</tt>). Alternatively, OpenSUSE and SLE users can use the package from <a href="https://build.opensuse.org/package/show?package=quirc&project=server%3Airc">the openSUSE Build Service</a>. Others should pester their distributor to provide a package.</p>
<p>Once you&apos;ve installed quIRC, you will want to connect to a server and join a channel. Good places to start are #quirc on NewNet, #newbies on EFnet, or #irchelp on ColdFront. We&apos;ll walk you through connecting to #quirc.</p>
<p>First, choose and set your nickname; you can use your real name or any handle you like to go by. Try not to pick anything too common, like &apos;john&apos;, as it&apos;s likely to already be in use. Set your nickname with <tt>/nick <em>yournickhere</em></tt>.</p>
<p>Next, connect to the NewNet network, with <tt>/server irc.newnet.net</tt>. A new tab will open, and various information, including the <acronym title="Message Of The Day">MOTD</acronym>, will scroll by. If you get a message like &quot;foobar: Nickname is in use&quot;, choose a different nick.</p>

0 comments on commit 0da630e

Please sign in to comment.