This commit is contained in:
gferg 2002-08-11 20:09:09 +00:00
parent 8aaa458478
commit 137b740f1e
5 changed files with 426 additions and 319 deletions

View File

@ -13,7 +13,7 @@
<address><email>rick@linuxmafia.com</email></address>
</affiliation>
</author>
<pubdate>1.3, 2002-08-07</pubdate>
<pubdate>1.3.2, 2002-08-08</pubdate>
<copyright>
<year>2002</year>
@ -63,12 +63,12 @@ Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.</para>
<para>Several things. In an era when leading word processors gobble dozens of megs of RAM just launching, WP (v. 8.x) is thrifty -- about 6 MB. By comparison, OpenOffice.org 1.0.1 or Star Office 6.0 takes 73 MB to launch. (On the other hand, AbiWord 1.02 also uses only 6 MB, and KWord 1.1.1 a moderate 17 MB.) It's a stable, fast, polished, full-featured product. It has "reveal codes". It has a nearly unique "shrink to fit" printing feature that quickly becomes indispensible once you've experienced it. WP's print module uses the MS-DOS version's time-tested, robust printer drivers by default, expanding greatly the range of compatible printers. (WP can alternatively hand off to standard Unix printing subsystems -- lpr/lprng/gnulpr/cups/pdq/etc. -- in "Passthru Postscript" mode.) It has excellent built-in mathematical, financial, logical, and string-handling functions. It has excellent table support and a useful speed-table-formatting feature. It has a robust built-in database engine for table sorting and searching.</para>
<para>It's still the best tool available on Linux for reading WordPerfect .wpd files created elsewhere. (Star Office, AbiWord, and wp2latex also qualify.)</para>
<para>It's still the best tool available on Linux for reading WordPerfect .wpd files created elsewhere. (AbiWord and wp2latex also qualify.)</para>
</sect3>
<sect3 id="whatswrong"><title>What's wrong with WordPerfect?</title>
<para>It's a discontinued product (on Linux). The most-long-term-available version, WP 8.0 Download Personal Edition (WP 8.0 DPE), has deliberately crippled font handling and limited multilanguage support, and won't function without fairly antique support libraries. The best version, WP 8.1 Personal Edition, comes only bundled with the Corel Linux OS (CLOS) Deluxe Edition boxed set, v. 1.0 or 1.2 -- likewise discontinued.</para>
<para>It's a discontinued product (on Linux). The most-long-term-available version, WP 8.0 Download Personal Edition (WP 8.0 DPE), has deliberately crippled font handling and limited multilanguage support, and won't function without fairly antique support libraries. The best version, WP 8.1, comes only bundled with the Corel Linux OS (CLOS) Deluxe and Standard Edition boxed sets, v. 1.0 or 1.2 -- likewise discontinued.</para>
<para>WP used to be the best tool on Linux for reading MS-Word files, but always faltered on some, especially those Fast Saved in MS-Word. But now, Star Office, OpenOffice.org, and AbiWord reportedly do better.</para>
@ -81,7 +81,7 @@ Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.</para>
<sect3 id="whocreated"><title>Who created WordPerfect for Linux?</title>
<para>Old-timers may recall that WordPerfect originally emerged from Software Development Corporation (SD Corp) of Orem, Utah, which later renamed itself to WordPerfect Corporation. That firm eventually sold WordPerfect's codebase to Corel Corporation Limited of Ottawa, Canada. Corel then hired the other firm (renamed back to SD Corp) to port WP versions 6, 7, 8.0, and 8.1 to both Linux and several proprietary Unix platforms.</para>
<para>Old-timers may recall that WordPerfect originally emerged from Software Development Corporation (SD Corp) of Orem, Utah, which later renamed itself to WordPerfect Corporation. That firm eventually sold WordPerfect's codebase to Novell, Inc., which then sold it to Corel Corporation Limited of Ottawa, Canada. Corel then hired the first firm (renamed back to SD Corp) to port WP versions 6, 7, 8.0, and 8.1 to both Linux and several proprietary Unix platforms.</para>
<para>The latest and seemingly final WP version for Linux was v. 9, better known as WordPerfect Office 2000 (which was technically WordPerfect joined at the hip to several other Corel programs -- Quattro Pro, Paradox, Corel Presentations, Corel Central), was produced by Corel Corporation Limited, alone.</para>
</sect3>
@ -112,12 +112,12 @@ Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.</para>
<para>WP 8.0 Personal Edition for Linux was offered in boxed sets, and was offered bundled with the book "WordPerfect for Linux Bible" by Stephen E. Harris and Erwin Zijleman. It included 140 fonts, the font-installer module "xwpfi" (see: <ulink url="http://www.rodsbooks.com/wpfonts/wpfonts-fonts.html">http://www.rodsbooks.com/wpfonts/wpfonts-fonts.html</ulink>), and support for grammar/spelling checkers and thesaurus lookups in additional (non-English) languages. The CD-ROM includes a text file with a registration key.</para>
<para>WP 8.0 Light Edition for Linux was the bundled WP copy included in boxed sets of CLOS Standard Edition. My best guess is that this was exactly the same program as WP 8.0 DPE except in .deb package format, licensed without the prohibition against commercial use, and probably furnished with a registration key (or fixed to not need one).</para>
<para>Next came WP 8.1 Personal Edition for Linux (WP 8.1 PE), arguably the best version to date. It came only in boxed sets of CLOS Deluxe Edition versions 1.0 and 1.2. (CLOS 1.2 was better known as "Second Edition", a name Corel evidently pitched at MS-Windows users.)</para>
<para>WP 8.1 PE differed from prior versions in several ways. It wasn't licensed for multiuser (only Server Editions included multiuser support and console-mode WP; I know of no 8.1 Server Editions), but was licensed for commercial use. As part of CLOS Deluxe Edition, it was in .deb package format. Redistribution was/is strictly prohibited. It came with a full set of 300 fonts, the font-installer module, network support, WP Draw, and equation editor, and a printed manual. It ships with and installs all required libraries.</para>
<para>WP 8.1 Light Edition for Linux was the bundled WP copy included in boxed sets of CLOS Standard Edition. According to one report, it differs from WP 8.1 PE only in having approximately 1/3 as many included fonts (only one of the Deluxe bundle's three .deb-format font archives).</para>
<para>The latest and apparently final WP version for Linux was v. 9, promoted by Corel as "WordPerfect Office 2000". This FAQ will have little to say about WP 9 for Linux, as it was not a true native port, but rather consisted of Win32 binary code running in a winelib emulation environment -- with predictable RAM bloat and instability, as a result. (Boxed sets only were offered.)</para>
</sect2>
</sect1>
@ -131,7 +131,7 @@ Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.</para>
<para>What binary packages these libs and dynamic loader will occupy differs between distributions. If in doubt, documents linked from <ulink url="http://linux-sxs.org/edit.html">http://linux-sxs.org/edit.html</ulink> may give details for your distribution.</para>
</sect2>
<sect2 id="fitrix"><title>How do I fix MS-Word import/export filters (the Filtrix module) on WP 8.0/8.1 for Linux?</title>
<sect2 id="fitrix"><title>How do I fix MS-Word import/export filters (the Filtrix module) on WP 8.x for Linux?</title>
<para>The third-party Filtrix module, because of a programming oversight concerning date-handling, doesn't work on systems whose current date is set later than September 9, 2001: On attempts to import/export MS-Word files, it fails with error message "Filtrix unable to convert this file". The problem can be fixed by installing a wrapper by Valentijn Sessink, available at <ulink url="http://olivier.pk.wau.nl/~valentyn/wp8fix/">http://olivier.pk.wau.nl/~valentyn/wp8fix/</ulink>.</para>
@ -220,9 +220,9 @@ Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.</para>
<listitem><para><ulink url="http://linux-sxs.org/edit.html">http://linux-sxs.org/edit.html</ulink></para></listitem>
<listitem><para><ulink url="http://linux-sxs.org/wp8.html">http://linux-sxs.org/wp8.html</ulink></para></listitem>
<listitem><para><ulink url="http://www.libranet.com/support/view.cgi?item=WP8Libranet2.html">http://www.libranet.com/support/view.cgi?item=WP8Libranet2.html</ulink></para></listitem>
<listitem><para><ulink url="http://www.linux-magazin.de/ausgabe/1999/12/WordPerfect1/wordperfect1.html">http://www.linux-magazin.de/ausgabe/1999/12/WordPerfect1/wordperfect1.html</ulink> (German language)</para></listitem>
<listitem><para><ulink url="http://www.linux-magazin.de/ausgabe/1999/12/WordPerfect1/wordperfect1.html">http://www.linux-magazin.de/ausgabe/1999/12/WordPerfect1/wordperfect1.html</ulink> (in German language)</para></listitem>
<listitem><para><ulink url="http://www.dalug.nu/lnx/review-wp.html">http://www.dalug.nu/lnx/review-wp.html</ulink></para></listitem>
<listitem><para><ulink url="http://content.443.ch/pub/linfiles/Gnusoft/wordperfect8/">http://content.443.ch/pub/linfiles/Gnusoft/wordperfect8/</ulink> (additional language modules)</para></listitem>
<listitem><para><ulink url="http://content.443.ch/pub/linfiles/Gnusoft/wordperfect8/Readme.html">http://content.443.ch/pub/linfiles/Gnusoft/wordperfect8/Readme.html</ulink> (info on additional language modules)</para></listitem>
<listitem><para><ulink url="http://howto.lycos.com/lycos/topic/1,,10+57+26117,00.html">http://howto.lycos.com/lycos/topic/1,,10+57+26117,00.html</ulink></para></listitem>
<listitem><para><ulink url="http://www.qwkscreen.com/WPLinuxLinks.html">http://www.qwkscreen.com/WPLinuxLinks.html</ulink></para></listitem>
<listitem><para><ulink url="http://users.lightbearer.com/set/wp/">http://users.lightbearer.com/set/wp/</ulink></para></listitem>
@ -230,7 +230,7 @@ Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.</para>
<listitem><para><ulink url="http://www.tldp.org/HOWTO/mini/WordPerfect.html">http://www.tldp.org/HOWTO/mini/WordPerfect.html</ulink></para></listitem>
<listitem><para><ulink url="http://unix.wizard.ca/wplinux/">http://unix.wizard.ca/wplinux/</ulink></para></listitem>
<listitem><para><ulink url="http://zinc.ichf.edu.pl/wordperfect/">http://zinc.ichf.edu.pl/wordperfect/</ulink> (Polish language)</para></listitem>
<listitem><para><ulink url="http://www.geocities.co.jp/SiliconValley-PaloAlto/8336/work-wp8.html">http://www.geocities.co.jp/SiliconValley-PaloAlto/8336/work-wp8.html</ulink> (Japanese language)</para></listitem>
<listitem><para><ulink url="http://www.geocities.co.jp/SiliconValley-PaloAlto/8336/work-wp8.html">http://www.geocities.co.jp/SiliconValley-PaloAlto/8336/work-wp8.html</ulink> (in Japanese language)</para></listitem>
</itemizedlist>
</sect2>
@ -254,7 +254,7 @@ Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.</para>
<sect2 id="uplicence8"><title>Suppose I suddenly need to use my copy of WP 8.0 DPE for Linux in a commercial setting. Can I upgrade my licence?</title>
<para>No. Corel made no provision for that, and discontinued all Linux operations in May 2001. At this late date, your best bet is probably to seek out a boxed set of CLOS Deluxe Edition for its copy of WP 8.1 PE.</para>
<para>No. Corel made no provision for that, and discontinued all Linux operations in May 2001. At this late date, your best bet is probably to seek out a boxed set of CLOS Deluxe or Standard Edition for its copy of WP 8.1.</para>
</sect2>
<sect2 id="upfont8"><title>How can I add more fonts to WP 8.0 DPE?</title>
@ -266,7 +266,7 @@ Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.</para>
<para>At one time, Corel offered free-of-charge localisation add-ons for nine other languages and countries, at <ulink url="http://linux.corel.com/products/wp8/download_instr.htm">http://linux.corel.com/products/wp8/download_instr.htm</ulink>, but removed them not long after it closed down its Linux division in May 2001.</para>
<para>However, in FAQ section 4.1, you'll find links for additional-language tarballs I've found for FR=France, UK=United Kingdom, and DE=Germany. If anyone finds any of the other six, please let me know. (The ES=Spain archive in a sibling directory of the French one is unfortunately corrupted.) They were as follows: Canadian English (large archive guilgce0.gz or split format guice00.gz - guice03.gz), French (large archive guilgfr0.gz or split format guifr00.gz - guifr03.gz), Australian English (large archive guilgoz0.gz or split format guioz00.gz - guioz05.gz), Canadian French (large archive guilgcf0.gz or split format guicf00.gz - guicf04.gz), Dutch (large archive guilgnl0.gz or split format guinl00.gz - guinl03.gz), and Italian (large archive guilit0.gz or split format guiit00.gz - guiit03.gz).</para>
<para>However, in FAQ section 4.1, you'll find links for additional-language tarballs I've found for FR=French, UK=United Kingdom English, and DE=German. If anyone finds any of the other six, please let me know. (The ES=Spanish archive in a sibling directory of the French one is unfortunately corrupted.) They were as follows: Canadian English (large archive guilgce0.gz or split format guice00.gz - guice03.gz), French (large archive guilgfr0.gz or split format guifr00.gz - guifr03.gz), Australian English (large archive guilgoz0.gz or split format guioz00.gz - guioz05.gz), Canadian French (large archive guilgcf0.gz or split format guicf00.gz - guicf04.gz), Dutch (large archive guilgnl0.gz or split format guinl00.gz - guinl03.gz), and Italian (large archive guilit0.gz or split format guiit00.gz - guiit03.gz).</para>
<para>The language tarballs (which, despite the "gz" extension, are actually .tar.gz files) have a "Runme" installation script, which takes care of all installation details, and localises all aspects of the program. If, on the other hand, you find a source for just the .lex dictionary files, copy them as the root user to WP8's "shlib10" directory. Start xwp with the -admin (or -adm) command-line option. Find the option to add additional languages. Exit xwp. In either case, after installing the language files, start xwp with the "-lang" option to override the US English default, e.g.. "xwp -lang de".</para>
@ -282,44 +282,44 @@ Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.</para>
<sect1 id="nondownloadwp8"><title>Non-downloadable WP 8</title>
<sect2 id="getwp81"><title>Where can I find a copy of WP 8.1 PE for Linux?</title>
<sect2 id="getwp81"><title>Where can I find a copy of WP 8.1 for Linux?</title>
<para>That version is available only inside boxed sets of CLOS Deluxe Edition versions 1.0 and 1.2. Nowhere else. There was never a "download edition", and Corel's licence terms strictly forbid redistribution.</para>
<para>That version is available only inside boxed sets of CLOS Deluxe Edition and CLOS Standard Edition (the latter having fewer bundled fonts), versions 1.0 and 1.2. Nowhere else. There was never a "download edition", and Corel's licence terms strictly forbid redistribution.</para>
<para>CLOS Deluxe Edition v. 1.2 aka "Second Edition" is still available for US $85 at <ulink url="http://www.cheapbytes.com/">http://www.cheapbytes.com/</ulink> , and can frequently be found on eBay. Cassam Computers, <ulink url="http://mypage.uniserve.ca/~pdj/Linux.html">http://mypage.uniserve.ca/~pdj/Linux.html</ulink>, has it for CAN $100. EMS Professional Software and Consulting, <ulink url="http://www.emsps.com/oldtools/misc-c.htm">http://www.emsps.com/oldtools/misc-c.htm</ulink>, has it for US $100.</para>
<para>CLOS Deluxe Edition v. 1.2 aka "Second Edition" is still available for US $85 at <ulink url="http://www.cheapbytes.com/">http://www.cheapbytes.com/</ulink> , and can frequently be found on eBay. Cassam Computers, <ulink url="http://mypage.uniserve.ca/~pdj/Linux.html">http://mypage.uniserve.ca/~pdj/Linux.html</ulink>, has Deluxe Edition for CAN $100 and Standard Edition for CAN $40. EMS Professional Software and Consulting, <ulink url="http://www.emsps.com/oldtools/misc-c.htm">http://www.emsps.com/oldtools/misc-c.htm</ulink>, has xDeluxe Edition for US $100.</para>
<para>Please note that downloading an ISO9660 (CD-ROM) image of CLOS absolutely does not do the trick: That will be CLOS Download Edition, which has no version of WP for Linux at all. You need CLOS Deluxe Edition, one of the two boxed sets -- not CLOS Standard Edition (the other boxed set), and not CLOS Download Edition.</para>
<para>Please note that downloading an ISO9660 (CD-ROM) image of CLOS absolutely does not do the trick: That will be CLOS Download Edition, which has no version of WP for Linux at all. You need CLOS Deluxe or Standard Edition, the two boxed sets -- not CLOS Download Edition.</para>
</sect2>
<sect2 id="wp8v81"><title>What does WP 8.1 PE give me that's not in WP 8.0 DPE?</title>
<sect2 id="wp8v81"><title>What does WP 8.1 give me that's not in WP 8.0 DPE?</title>
<para>Electronic (PDF) and paperbound reference manuals and an electronic (PDF) user's manual, the font-installer module, WP Draw (the drawing/charting module), the module to create custom dictionaries and hyphenation databases, an equation editor, network support, a print-queue manager, prepaid technical support, sample documents/templates/textures/clipart/photos, and 300 fonts. Also, much better handling of watermarks, multiple language support in the spelling checker / grammar checker / thesaurus, more-current printer drivers and better printer setup, and no need to get a registration key. The necessary support libraries are also included and installed automatically. Corel Draw is also included (in a separate package).</para>
<para>Electronic (PDF) and paperbound reference manuals and an electronic (PDF) user's manual, the font-installer module, WP Draw (the drawing/charting module), the module to create custom dictionaries and hyphenation databases, an equation editor, network support, a print-queue manager, prepaid technical support, sample documents/templates/textures/clipart/photos, and 300 fonts (with WP 8.1 PE; about 100 with WP 8.1 Light). Also, much better handling of watermarks, multiple language support in the spelling checker / grammar checker / thesaurus, more-current printer drivers and better printer setup, and no need to get a registration key. The necessary support libraries are also included and installed automatically. Corel Draw is also included (in a separate package).</para>
</sect2>
<sect2 id="licence81"><title>What are the licence restrictions on WP 8.1 PE for Linux?</title>
<sect2 id="licence81"><title>What are the licence restrictions on WP 8.1 for Linux?</title>
<para>You may install it only on two machines at a time, for use by only a single user. You may not reverse-engineer or modify it. You must be in compliance with export laws and not associated with countries the USA considers naughty, like Cuba. You mustn't be on the USA Treasury or Commerce Department's lists of naughty people (drug smugglers, terrorists, export-regs violators, etc.). You mustn't allow use of the program to violate USA law.</para>
<para>Please note that, unlike WP 8.0 DPE, WP 8.1 PE is licensed for commercial usage.<para>
<para>Please note that, unlike WP 8.0 DPE, WP 8.1 is licensed for commercial usage.<para>
<para>The full licence text may be studied here: <ulink url="http://linuxmafia.com/pub/linux/apps/corel-wordperfect-8.1-licence">http://linuxmafia.com/pub/linux/apps/corel-wordperfect-8.1-licence</ulink></para>
</sect2>
<sect2 id="clos11"><title>Why was WP missing from CLOS Deluxe Edition version 1.1?</title>
<sect2 id="clos11"><title>Why was WP missing from CLOS Deluxe/Standard Editions version 1.1?</title>
<para>CLOS Deluxe Edition v. 1.1 was available only as an upgrade to apply to v. 1.0, not as a separate product. So, you didn't get a copy of WP because you already had one.</para>
<para>CLOS Deluxe and Standard Editions v. 1.1 were available only as upgrades to apply to corresponding v. 1.0 boxed sets, not as standalone products. So, you didn't get a copy of WP because you already had one.</para>
</sect2>
<sect2 id="install81"><title>How do I install WP 8.1 PE (from a CLOS Deluxe Edition boxed set) on some other Linux distribution?</title>
<sect2 id="install81"><title>How do I install WP 8.1 (from a CLOS boxed set) on some other Linux distribution?</title>
<para>The file you'll need from the CLOS Deluxe Edition CD-ROM is a 40 MB one called wp-full_8.1-nn_i386.deb, where "nn" is the package version number, which will depend on the vintage of CLOS you have (and doesn't matter much). On any .deb-based distribution (such as Debian, CLOS, Xandros Desktop, Libranet, Stormix, Progeny, etc.), just do "dpkg -i packagename", as usual. WP probably won't be auto-added to your distribution's menus: The startup binary is "xwp".</para> <para>On other distributions, you can use Joey Hess's "alien" utility to create an approximately equivalent RPM package, a Slackware .tgz package, a Solaris .pkg package, or a Stampede Linux .slp package. Alternatively, you can use the standard "ar" archive utility to pull apart the .deb file and install the pieces manually. The HOWTO documents linked from <ulink url="http://linux-sxs.org/edit.html">http://linux-sxs.org/edit.html</ulink> will probably help, there.</para> <para>CLOS Deluxe Edition also includes three .deb packages of PostScript Type 1 fonts (fonts-16_1.0-5.deb, fonts-69_1.0-4.deb, and fonts-115_1.0-4.deb), which are likewise useful on other Linux distributions. (You may also want the type1inst_0.6.1-6_i386.deb package, if you don't already have the Type 1 Font Installer utility.) On CLOS, they install to /usr/X11R6/lib/X11/fonts/Type1/ , making them available to the system generally. You can either convert the .debs as detailed above for WP itself, or grab the font files from /usr/X11R6/lib/X11/fonts/Type1/.</para>
<para>The main file you'll need from the CLOS boxed-set CD-ROM is a 40 MB one called wp-full_8.1-nn_i386.deb, where "nn" is the package version number, which will depend on the vintage of CLOS you have (and doesn't matter much). On any .deb-based distribution (such as Debian, CLOS, Xandros Desktop, Libranet, Stormix, Progeny, etc.), just do "dpkg -i packagename", as usual. WP probably won't be auto-added to your distribution's menus: The startup binary is "xwp".</para> <para>On other distributions, you can use Joey Hess's "alien" utility to create an approximately equivalent RPM package, a Slackware .tgz package, a Solaris .pkg package, or a Stampede Linux .slp package. Alternatively, you can use the standard "ar" archive utility to pull apart the .deb file and install the pieces manually. The HOWTO documents linked from <ulink url="http://linux-sxs.org/edit.html">http://linux-sxs.org/edit.html</ulink> will probably help, there.</para> <para>CLOS Deluxe Edition also includes three .deb packages of PostScript Type 1 fonts (fonts-16_1.0-5.deb, fonts-69_1.0-4.deb, and fonts-115_1.0-4.deb), which are likewise useful on other Linux distributions. CLOS Standard Edition differs only in omitting the second two fonts packages mentioned. (You may also want the type1inst_0.6.1-6_i386.deb package, if you don't already have the Type 1 Font Installer utility.) On CLOS, they install to /usr/X11R6/lib/X11/fonts/Type1/ , making them available to the system generally. You can either convert the .debs as detailed above for WP itself, or grab the font files from /usr/X11R6/lib/X11/fonts/Type1/.</para>
<para>Font-addition procedures within WP 8.1 PE itself are covered in the next FAQ item.</para>
<para>Font-addition procedures within WP 8.1 itself are covered in the next FAQ item.</para>
<para>Leon A. Goldstein's HOWTO for installing WP 8.x on Libranet gives more detail: <ulink url="http://www.libranet.com/support/view.cgi?item=WP8Libranet2.html">http://www.libranet.com/support/view.cgi?item=WP8Libranet2.html</ulink></para>
</sect2>
<sect2 id="fonts81"><title>How do I add fonts to WP 8.1 PE?</title>
<sect2 id="fonts81"><title>How do I add fonts to WP 8.1?</title>
<para>First, as the root user, physically place them in /usr/X11R6/lib/X11/fonts/Type1/ , or wherever system-wide Type 1 fonts go on your distribution. While in that directory, run "type1inst" (usually in /usr/X11R6/lib/X11/fonts/Type1), then "mkfontdir". The fonts will now be available to all applications using PostScript Type 1 fonts.</para>
@ -332,9 +332,9 @@ Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.</para>
<para>Please note also that ideally you'll be adding any fonts to any WP 8.x version twice, once as a screen font and once as a printer font. This matter is covered comprehensively by Rod Smith at <ulink url="http://www.rodsbooks.com/wpfonts/">http://www.rodsbooks.com/wpfonts/</ulink>.</para>
</sect2>
<sect2 id="closvers"><title>What's the difference between the WP versions bundled with CLOS Deluxe Edition versions 1.0 and 1.2?</title>
<sect2 id="closvers"><title>What's the difference between the WP versions bundled with CLOS boxed-set versions 1.0 and 1.2?</title>
<para>CLOS 1.0's CD-ROM also includes a second .deb package (package name "wp-manual") containing an electronic WP manual. However, that manual is for the non-Linux Unix version, so its omission from CLOS 1.2 is no big loss. (The same manual in PDF format can be retrieved from <ulink url="http://content.443.ch/pub/linfiles/Gnusoft/wordperfect8/wp8gui.pdf">http://content.443.ch/pub/linfiles/Gnusoft/wordperfect8/wp8gui.pdf</ulink>.) The boxed set's paperbound WP manual is a lot more useful, anyway.</para>
<para>CLOS 1.0 boxed sets' CD-ROM also includes a second .deb package (package name "wp-manual") containing an electronic WP manual. However, that manual is for the non-Linux Unix version, so its omission from CLOS 1.2 is no big loss. (The same manual in PDF format can be retrieved from <ulink url="http://content.443.ch/pub/linfiles/Gnusoft/wordperfect8/wp8gui.pdf">http://content.443.ch/pub/linfiles/Gnusoft/wordperfect8/wp8gui.pdf</ulink>.) The boxed sets' paperbound WP manual is a lot more useful, anyway.</para>
<para>Also among the additions in CLOS 1.2 was a WINE (non-Linux-native) port of Corel PhotoPaint 9 (which is also available for free-of-charge download from <ulink url="ftp://ftp2.corel.com/pub/linux/PhotoPaint9/">ftp://ftp2.corel.com/pub/linux/PhotoPaint9/</ulink>).</para>
</sect2>
@ -373,7 +373,7 @@ port?</title>
<sect2 id="wpbooks"><title>What books are available concerning WP for
Linux?</title>
<para>"Special Edition Using Corel WordPerfect 8 for Linux" by Roderick W. Smith (Que, ASIN 0789720329, US $4 on <ulink url="http://www.amazon.com/exec/obidos/ASIN/0789720329/qid%3D1028107345/sr%3D11-1/ref%3Dsr%5F11%5F1/102-5929383-6737760">Amazon.com</ulink>) and "WordPerfect for Linux Bible" by Stephen E. Harris and Erwin Zijleman (IDG Books, ISBN 0764533746, US $40 on <ulink url="http://www.amazon.com/exec/obidos/ASIN/0764533746/qid%3D1028107552/sr%3D11-1/ref%3Dsr%5F11%5F1/102-5929383-6737760">Amazon.com)</ulink>. The latter includes a copy of WP 8.0 (non-download) Personal Edition. This differs from WP 8.0 DPE in inclusion of 150 fonts, a font-installer utility, and support for grammar/spelling checkers and thesaurus lookups in multiple languages. The CD-ROM includes a text file containing a registration key, and the licence doesn't bar commercial usage.</para>
<para>"Special Edition Using Corel WordPerfect 8 for Linux" by Roderick W. Smith (Que, ASIN 0789720329, US $4 on <ulink url="http://www.amazon.com/exec/obidos/ASIN/0789720329/qid%3D1028107345/sr%3D11-1/ref%3Dsr%5F11%5F1/102-5929383-6737760">Amazon.com</ulink>) and "WordPerfect for Linux Bible" by Stephen E. Harris and Erwin Zijleman (IDG Books, ISBN 0764533746, US $40 on <ulink url="http://www.amazon.com/exec/obidos/ASIN/0764533746/qid%3D1028107552/sr%3D11-1/ref%3Dsr%5F11%5F1/102-5929383-6737760">Amazon.com)</ulink>. The latter includes a copy of WP 8.0 (non-download) Personal Edition. This differs from WP 8.0 DPE in inclusion of 140 fonts, a font-installer utility, and support for grammar/spelling checkers and thesaurus lookups in multiple languages. The CD-ROM includes a text file containing a registration key, and the licence doesn't bar commercial usage.</para>
<para>The Smith book is valuable for its highly-comprehensive coverage of Linux topics; the Harris and Zijleman one for its bundled software. Both are recommended.</para>
@ -439,7 +439,7 @@ Linux?</title>
<listitem><para>KDE KOffice suite's <ulink url="http://koffice.kde.org/kword/">KWord</ulink> word processor. Frame-oriented. Qt-based. Supports MS-Word, Anyware Words/Applix Words, AbiWord formats. Medium-good MS doc compatibility. No .wpd support.</para></listitem>
<listitem><para>SIAG Office suite's <ulink url="http://siag.nu/pw/">Pathetic Writer</ulink> word processor. Supports RTF. Supports MS-Word via WVware. Athena-based. No .wpd support.</para></listitem>
<listitem><para><ulink url="http://www.eeyore-mule.demon.co.uk/">Maxwell</ulink> word processor. Motif-based (not yet LessTif). Supports RTF. No .wpd support.</para></listitem>
<listitem><para><ulink url="http://www.oksid.ch/flwriter/">FLWriter</ulink> (Fast Light Writer). Xhtml file format with UTF-8 encoding, excellent multilanguage support, spelling checker. Exports RTF 1.5. No .wpd support.</para></listitem>
<listitem><para><ulink url="http://www.oksid.ch/flwriter/">FLWriter</ulink> (Fast Light Writer). XHTML file format with UTF-8 encoding, excellent multilanguage support, spelling checker. Exports RTF 1.5. No .wpd support.</para></listitem>
<listitem><para><ulink url="http://www.nllgg.nl/Ted/">Ted</ulink>. Simple word processor similar in spirit to MS-Windows's WordPad. RTF is native format. Motif/LessTif-based. Supports PDF, PostScript. No .wpd support.</para></listitem>
<listitem><para>CMU <ulink url="http://www-2.cs.cmu.edu/~AUIS/">Andrew User Interface System</ulink> (auis) package's EZ editor mode. Uses a well-thought-out system of ASCII + style/template markup. Supports RTF. No .wpd support.</para></listitem>
<listitem><para><ulink url="http://www.lyx.org/">LyX</ulink> (slick graphical front-end to LaTeX). Implements ASCII + TeX markup in a quasi-WYSIWYG graphical environment. You write structured documents (discussed below), but the process is made graphical and fairly easy. Produces reliable, high-quality output. Excellent built-in help. Supports LinuxDoc, DocBook, LaTeX, PostScript, DVI, ASCII. Xforms or Qt-based, with GTK+ integration pending. No .wpd support.</para></listitem>
@ -462,7 +462,7 @@ Linux?</title>
<sect1 id="feedback"><title>Feedback. Location. Copyright and Redistribution Terms.</title>
<para>This FAQ is maintained by Rick Moen (<ulink url="mailto:rick@linuxmafia.com">rick@linuxmafia.com</ulink>), to whom all corrections and suggestions should be addressed. The latest revision can always be found at <ulink url="http://linuxmafia.com/wpfaq/">http://linuxmafia.com/wpfaq/</ulink> and the master DocBook SGML source at <ulink url="http://linuxmafia.com/wpfaq/wordperfect-linux-faq.sgml">http://linuxmafia.com/wpfaq/wordperfect-linux-faq.sgml</ulink>. I use the toolset described in the LDP Author Guide, <ulink url="http://www.tldp.org/LDP/LDP-Author-Guide/">http://www.tldp.org/LDP/LDP-Author-Guide/</ulink>.</para>
<para>This FAQ is maintained by Rick Moen (<ulink url="mailto:rick@linuxmafia.com">rick@linuxmafia.com</ulink>), to whom all corrections and suggestions should be addressed. The latest revision can always be found at <ulink url="http://linuxmafia.com/wpfaq/">http://linuxmafia.com/wpfaq/</ulink> (multipage HTML) or <ulink url="http://linuxmafia.com/wpfaq/wpfaq-singlepage.html">http://linuxmafia.com/wpfaq/wpfaq-singlepage.html</ulink> (single-page HTML) and the master DocBook SGML source at <ulink url="http://linuxmafia.com/wpfaq/wordperfect-linux-faq.sgml">http://linuxmafia.com/wpfaq/wordperfect-linux-faq.sgml</ulink>. I use the toolset described in the LDP Author Guide, <ulink url="http://www.tldp.org/LDP/LDP-Author-Guide/">http://www.tldp.org/LDP/LDP-Author-Guide/</ulink>.</para>
<para>Contents are Copyright (C) 2002, Rick Moen.</para>

View File

@ -1281,7 +1281,7 @@ software provided by the Linux/IrDA project. </Para>
Wireless-Link-sys-WPC11</ULink>,
<CiteTitle>Link-sys WPC11 Mini-HOWTO</CiteTitle>
</Para><Para>
<CiteTitle>Updated: June 2002</CiteTitle>.
<CiteTitle>Updated: August 2002</CiteTitle>.
How to set up a Wireless Link-Sys WPC11 card
using a Link-SYS Wireless Access Point/DSL/Switch on a Debian system. </Para>
</ListItem>

View File

@ -1711,7 +1711,7 @@ How to setup a Wacom Graphire USB tablet for use with Linux. </Para>
Wireless-Link-sys-WPC11</ULink>,
<CiteTitle>Link-sys WPC11 Mini-HOWTO</CiteTitle>
</Para><Para>
<CiteTitle>Updated: June 2002</CiteTitle>.
<CiteTitle>Updated: August 2002</CiteTitle>.
How to set up a Wireless Link-Sys WPC11 card
using a Link-SYS Wireless Access Point/DSL/Switch on a Debian system. </Para>
</ListItem>

View File

@ -540,7 +540,7 @@ and more. </Para>
Wireless-Link-sys-WPC11</ULink>,
<CiteTitle>Link-sys WPC11 Mini-HOWTO</CiteTitle>
</Para><Para>
<CiteTitle>Updated: June 2002</CiteTitle>.
<CiteTitle>Updated: August 2002</CiteTitle>.
How to set up a Wireless Link-Sys WPC11 card
using a Link-SYS Wireless Access Point/DSL/Switch on a Debian system. </Para>
</ListItem>

View File

@ -1,19 +1,26 @@
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V4.1//EN">
<article>
<articleinfo>
<title>Debian Link-sys WPC11 Mini-HOWTO</title>
<author>
<firstname>Gerardo</firstname>
<surname>Arnaez</surname>
<affiliation>
<address>
<email>garnaez_((AT))_yahoo.com</email>
</address>
</affiliation>
</author>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V4.1//EN">
<article>
<articleinfo>
<title>Debian Link-sys WPC11 Mini-HOWTO</title>
<author>
<firstname>Gerardo</firstname>
<surname>Arnaez</surname>
<affiliation>
<address>
<email>garnaez_((AT))_yahoo.com</email>
</address>
</affiliation>
</author>
<revhistory>
<revision>
<revnumber>1.1.4</revnumber>
<date>2002-08-10</date>
<authorinitials>gea</authorinitials>
</revision>
<revision>
<revnumber>1.1.3</revnumber>
<date>2002-06-09</date>
@ -21,283 +28,383 @@
<revremark>Made clear what version on linux-wlan I actually used.</revremark>
</revision>
<revision>
<revnumber>1.1.2</revnumber>
<date>2002-05-26</date>
<authorinitials>gea</authorinitials>
<revremark>In part 2 of the HOWTO, the last item says make-kpkg --revision-custom.1.0 kernel_image when later on you used the correct one make-kpkg --revision=custom.1.0 kernel_image . Where there is an equal sign before the word custom and not a dash. This has been corrected. thanks to Raj Prakash, raj@rajeshprakash.com</revremark>
</revision>
<revision>
<revnumber>1.1.1</revnumber>
<date>2002-04-27</date>
<authorinitials>gea</authorinitials>
<revremark>some more grammer improvements, and highlighting to make things clearer</revremark>
<revision>
<revnumber>1.1.1</revnumber>
<date>2002-04-27</date>
<authorinitials>gea</authorinitials>
<revremark>some more grammer improvements, and highlighting to make things clearer</revremark>
</revision>
<revision>
<revnumber>1.1</revnumber>
<date>2002-04-13</date>
<authorinitials>gea</authorinitials>
<revremark>Correct grammar, made things a little more clearer, made software requirements more explicit.</revremark>
</revision>
<revision>
<revnumber>1.0</revnumber>
<date>2002-03-24</date>
<authorinitials>gea</authorinitials>
<revremark>Written because I spent enough figuring this out that I wanted to store "how I did it" somewhere I wouldn't lose it and figure you all might like it too.</revremark>
</revision>
</revhistory>
<abstract>
<indexterm>
<primary>Abstract</primary>
</indexterm>
<para>This is a Cookbook on how to set up a Wireless Link-Sys WPC11 card using a Link-SYS Wireless Access Point/DSL/Switch on a Debian system .
</para>
</abstract>
</articleinfo>
<sect1>
<TITLE>Link-sys WPC11 install on Debian</TITLE>
<sect2>
<title>Why Debian and why just this card?</title>
<para>I have been trying for months to get wireless working on Debian and after reading far and wide and getting help from irc.debian.org, I realized that there really is no Cookbook in getting wireless set up. Thus having just done it I want to commit to 'paper' so that you all can use it and I can refer to it knowing it is safe somewhere. :)
</para>
</sect2>
<sect2><title>Required Hardware</title>
<para>By required I mean, here is what I used to get this to work, and may serve as guide to anyone who wants to know what really works.</para>
<para>
BEFW11S4- EtherFast? Wireless AP + Cable/DSL Router w/4-Port Switch. I really really like this WAP (Wireless Access Point). It is OS independent (read, linux friendly) and is configured using a browser so no need to touch Microsoft software at all, even to configure it. And if you don't know what a switch is, let me tell ya, they rock. Essentially they allow the NIC to communicate in both directions at the same time. I highly recommend one.
</para>
<para>Link-sys WPC11. I have a version 3.0 and don't recommend any thing less than a version 2.5 Cost about 80 dollars</para>
</Sect2>
<sect2><title>Software Requirements</title>
<para>Debian Distribution. I find the 'testing' distribution to work well</para>
<para>go to <ulink url="http://www.linux-wlan.com/linux-wlan/">Absolute Systems</ulink> and download the 11Mbps linux-wlan(tm) Project</para>
<revnumber>1.1</revnumber>
<date>2002-04-13</date>
<authorinitials>gea</authorinitials>
<revremark>Correct grammar, made things a little more clearer, made software requirements more explicit.</revremark>
</revision>
<revision>
<revnumber>1.0</revnumber>
<date>2002-03-24</date>
<authorinitials>gea</authorinitials>
<revremark>Written because I spent enough figuring this out that I wanted to store "how I did it" somewhere I wouldn't lose it and figure you all might like it too.</revremark>
</revision>
<revision>
<revnumber>1.1.4</revnumber>
<date>2002-8-10</date>
<authorinitials>gea</authorinitials>
<revremark>I attempted to follow my own instruction on re-installing on the same laptop and found my how-to a little lacking. Have made things a bit clearer on what I am using. Also made a table to two</revremark>
</revision>
</revhistory>
<caution><para>I used version linux-wlan-ng-0.1.13.tar.gz to get it work. </para></caution>
<para> you need the pcmcia-cs. Get this by <screen>apt-get install pcmcia-cs</screen>
</para>
<para>This is different from pcmcia-source which I also asked you apt-get. Thus also do <screen>apt-get install pcmcia-source
</screen></para>
<para>You need the wireless tools so <screen>apt-get install wireless-tools</screen></para>
<para>You will also need some way to setup you IP address on your wireless card, I recommend either <screen>apt-get install DHCP-client</screen> to install the DHCP-client that will automatically configure your IP address, if you have a DHCP server. The WAP-11 hardware does provide DHCP server capabilities</para>
<para>Or at least have the <emphasis>pump</emphasis> application, which also will query a DHCP server and get you an IP address from the DHCP server. Note I tend to use <emphasis>pump</emphasis> when I am trying out new hardware to see if there is a connection, since to test a particular device, say <emphasis>eth0</emphasis> I would type <screen>pump -i eth0</screen> where the option <emphasis>-i</emphasis> tells <emphasis>pump</emphasis> what device to try to get an IP address. In this particular case, when I could not get Debian to automatically set up my wireless card, which was device <emphasis>wlan0</emphasis>, I would type <screen>pump -i wlan0</screen> and <emphasis>pump</emphasis> would try to set up the device. Anyway, the point is, that it is a good trouble shooting command, and you should know about it, and I talk more about it later.</para>
<para>I also recommend you use the "kernel-package" package when you want to build your new kernel, which I will get to. This tool is very good and you should be using it anyway when you are building new kernel for the Debian distribution. You can install it by typing <screen>apt-get install kernel-package</screen> Also, be sure to read the documentation it comes with, in case I don't do a good job explaining how to use it, later in this document
</para>
</sect2>
<sect2><title>Kernel Configuration</title>
<sect3><title>What TO enable</title>
<para>In order to use the wireless tools, like <emphasis>iwconfig</emphasis>, which will allow you tell how good your connection is, you need to enable support for <emphasis>Wireless LAN (Non-Ham Rasio)</emphasis>.</para>
<para>In these examples, I use <screen>make menuconfig</screen> to configure my kernel.</para>
<para>You can do this by:</para>
<literallayout>
Go to:
Network Device support -->
then Select:
Wireless LAN (non-hamradio) --->
</literallayout>
<para>
Then Choose the options,
so that it looks like below, or something
as close to this.
Note I am uing 'make menuconfig'
to configure my kernel
</para>
<literallayout>
[*] Wireless LAN (non-hamradio)
< > STRIP (Metricom starmode radio IP)
< > ATT WaveLAN & DEC RoamAbout DS support
< > Aironet Arlan 655 & IC2200 DS support
< > Aironet 4500/4800 series adapters
< > Cisco/Aironet 34X/35X/4500/4800 ISA and PCI cards
<*> Hermes chipset 802.11b support (Orinoco/Prism2/Symbol)
< > Hermes in PLX9052 based PCI adaptor support (Netgear MA301 et
</literallayout>
</sect3>
<sect3><title>What <emphasis>NOT</emphasis> to Enable</title>
<para>One of the main stumbling blocks was to realize that the <emphasis>pcmcia support in the kernel is not as good as the pcmcia-source support</emphasis> that one gets when you build it from pcmcia-source.
</para>
<para>I use either <screen>make xconfig</screen> or <screen>make menuconfig</screen> to configure my kernel, so when you configure your kernel, be sure to not have pcmcia support enabled under <screen>General setup</screen>
</para>
<para>Nor do you want to select any particular pcmcia card under <screen>Network device support</screen>. I repeat you do not want this under the kernel and you will be building it when you download pcmcia-source.</para> <caution><para>Be sure to download all the necessary components before you take pcmcia support out of the kernel, otherwise, if you were using a pcmcia card for net access, you will not be able to connect to the Internet using the new kernel, until you have built both pcmcia support and module drivers for the wireless card</para></caution>
</sect3>
</sect2>
</sect1>
<sect1>
<title>Using make-kpkg to build kernels</title>
<caution><para>Note: <emphasis>make-kpkg</emphasis> was installed when you installed <emphasis>kernel-package</emphasis></para></caution>
<para>Once you have configured your kernel just save and exit, and don't use make-kpkg yet! I will show you a good way to make sure sure everything builds well.</para>
<para>Follow the instruction in the make-kpkg documentation but essentially:</para>
<para>You need to be in the <screen>/usr/src/linux</screen> directory, then </para>
<screen>make-kpkg clean</screen>
<para>to clean all the binaries out and prepare to build a new kernel, then:</para>
<screen>make-kpkg --revision=custom.1.0 kernel_image</screen>
<caution><para>Don't Do this Yet!</para></caution>
<para>We need to get the pcmcia-source ready to be built at the same time as the kernel is built. This is a very neat feature of make-kpkg!</para>
</sect1>
<sect1><title>Building PCMCIA-SOURCE</title>
<para>First, be sure to download pcmcia-source, by typing <screen>apt-get install pcmcia-source</screen> This will download the source into <screen>/usr/src</screen> as <screen>pcmcia-source.tar.gz</screen></para>
<para>You now need to gunzip the file by <screen>gunzip pcmcia-source.tar.gz</screen> and then untar the file by <screen>tar xvf pcmcia-source.tar</screen></para>
<para>You should see pcmcia-source unpacked into the directory <screen>/usr/src/modules/pcmcia-cs</screen></para>
</sect1>
<sect1><title>Using make-kpkg to build the new kernel and pcmcia-source modules</title>
<para>Be sure the pcmcia-source is under /usr/src/modules.</para>
<para>Go ahead and configure your kernel and be sure that pcmcia support IS NOT compiled in as an option in the kernel.</para>
<para>To build the kernel and pcmcia-source, be sure you are under the <screen>/usr/src/linux</screen> or have a symbolic link from /usr/src/linux to whatever kernel source you have set up. Then type <screen>make-kpkg --revision=custom.1.0 kernel_image modules_image</screen></para>
<para>The <emphasis>kernel_image</emphasis> option will build the kernel while the <emphasis>modules_image</emphasis> option will build all modules located under <screen>/usr/src/modules/</screen>. So be sure that you do indeed want to rebuild any other modules that are located in source when you are ready to build your new kernel.</para>
<para>After some chugging, go up one level to <screen>/usr/src</screen> and you should see two new Debian packages that should look something like this:
<literallayout>
kernel-image-2.4.19-pre4_custom.1.0_i386.deb
pcmcia-modules-2.4.19-pre4_3.1.31-7+custom.1.0_i386.deb
</literallayout>
</para>
<para>You first want to install the kernel image so you would type <screen>dpkg -i kernel-image-etc....</screen></para>
<para>Now install the modules by typing <screen>dpkg -i pcmcia-modules.etc...</screen></para>
<caution><para>There are a couple of assumptions that make-kpkg makes about your lilo.conf file. One is that you have not radically changed it. Make-kpgk will make make symbolics links from '/boot' where the actual kernel resides to 'vmlinuz' which is under '/'. In other words, under '/', you will see <emphasis>vmlinuz</emphasis> and <emphasis>vmlinuz.old</emphasis> which are symbolic links to the real kernel images under <emphasis>/boot/</emphasis>. Anyway if you have any questions ask me.</para></caution>
</sect1>
<sect1><title>Wlan Drivers for You Link-Sys Card</title>
<para>You have downloaded the 11 Wlan project. Go a head and read the instruction, and put it under modules. Follow the instructions when you <screen>make config</screen> The one key is to make sure you specify the pcmcia-source as under <screen>/usr/src/modules/pcmcia-cs</screen> and not choose the default it gives you.</para>
<para>Go ahead and <screen>make all</screen> and <screen>make install</screen></para>
<para>I suggest you read the documentation that comes with it, but essentially, if you have a WAP that is connected to your DSL or cable modem then you have a infrastructure set up. I found that it was best to edit the <screen>networks.opt</screen> under the <screen>/etc/pcmcia</screen> directory.</para>
<para>To make things easier edit the option
<literallayout># Use DHCP (via /sbin/dhcpcd, /sbin/dhclient, or /sbin/pump)? [y/n]
DHCP="y"</literallayout> to what I have, i.e., set it to yes.
</para>
<para>The documentation talks about setting ESSID but when you edit the <screen>wlan-ng.opts</screen> you will only see
<literallayout>
#=======INFRASTRUCTURE STATION START===================
# SSID is all we have for now
AuthType="opensystem" # opensystem | sharedkey (requires WEP)
DesiredSSID="howardnet"
</literallayout>
</para>
<para>From what I can gather,DesiredSSID means ESSID and it works when the WAP and link-sys pcmcia card share the same name.</para>
<para>At this point, you should reboot and should have a working link-sys card that gets its address via DHCP.</para>
</sect1>
<sect1><title>Checking things in case they don't work</title>
<para>1. Be sure to type <screen>ifconfig</screen></para>
<para>You should something like this</para>
<literallayout>
lo Link encap:Local Loopback
inet addr:127.0.0.1 Mask:255.0.0.0
UP LOOPBACK RUNNING MTU:16436 Metric:1
RX packets:0 errors:0 dropped:0 overruns:0 frame:0
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:0
RX bytes:0 (0.0 b) TX bytes:0 (0.0 b)
wlan0 Link encap:Ethernet HWaddr 00:06:25:A8:AE:64
inet addr:192.168.1.104 Bcast:192.168.1.255 Mask:255.255.255.0
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
RX packets:35197 errors:0 dropped:0 overruns:0 frame:0
TX packets:57676 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:100
RX bytes:43386657 (41.3 MiB) TX bytes:2670811 (2.5 MiB)
Interrupt:3 Base address:0x100
</literallayout>
<para>The keys point here are that <emphasis>inet addr:</emphasis>has a real IP address, and that <emphasis>Bcast</emphasis> and <emphasis>Netmask</emphasis> are set up such that they are on the same "wave-length" as your Wireless Access Point.</para>
<para>2. If you don't, you might have had the same problem i did which was that there was no easy script to initiate the wlan0 device setup. That is to say, if the card was recognized but you still did not get a connection and say that ifconfig showed wlan0 present but with no IP address. In other words, you might see something like this:</para>
<para><literallayout>
text:/home/dude# ifconfig
lo Link encap:Local Loopback
inet addr:127.0.0.1 Mask:255.0.0.0
UP LOOPBACK RUNNING MTU:16436 Metric:1
RX packets:14 errors:0 dropped:0 overruns:0 frame:0
TX packets:14 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:0
RX bytes:700 (700.0 b) TX bytes:700 (700.0 b)
wlan0 Link encap:Ethernet HWaddr 00:06:25:A8:AE:64
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
RX packets:1 errors:0 dropped:0 overruns:0 frame:0
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:100
RX bytes:46 (46.0 b) TX bytes:0 (0.0 b)
Interrupt:3 Base address:0x100
</literallayout></para>
<para>As you can see, the interface device, the Wireless pcmcia card, is noted, but there is no <emphasis>inet addr</emphasis>. The pcmcia software recognized the card, but it has not successfully connected with the Wireless Access Point.</para>
<para>I used the command,<emphasis>pump</emphasis> to send a simple DHCP request to the DHCP server for the device in question. I used<screen>pump -i wlan0</screen> which essentially runs a simple DHCP request to set up that card, wlan0, in this case.</para>
<para>You can get the <emphasis>pump</emphasis> by <screen>apt-get install pump</screen></para>
<para>While I needed to use <screen>pump -i wlan0</screen> on my laptop, I did not need this when I set up the link-sys wireless WPC11 card on my girlfriend's laptop. She has a Link-Sys WPC11 version 2.5 pcmcia card.</para>
</sect1>
<sect1><title>Wireless tools</title>
<para>While it is not necessary to include this in your kernel configuration, you can enable Wireless tool extensions by going (i assume you use xconfig or menuconfig) to <screen>Network device support</screen> and then go to <screen>Wireless LAN (non-hamradio)</screen> and enable support for the <screen>Hermes chipset 802.11b support (Orinoco/Prism2/Symbol)</screen>. This will let you use the Wireless Tools like <screen>iwconfig</screen>, <screen>iwspy</screen> and such.</para>
<para>The one thing I found this good for is that by repeated typing iwconfig, you can see your Link Quality. Its quite good</para>
</sect1>
<sect1>
<title>Wireless Access Point</title>
<para>Perhaps its it missing the forest for the trees, but I did not spend any discussion setting up the actual Wireless Access Point. The reason is that the documentation that comes with the WAP is well written. The only thing I haven't spoken about is enabling Wireless Encryption Protocol in the WAP (Wireless Access Point) which I really don't suggest as I don't think WEP has been properly set up in the drivers for the Pcmcia Wireless Cards. However, let me know if you have any problems and I will be glad to help.
</para>
</sect1>
<sect1><title>Request for comments</title>
<para>I will be glad to help anyone out and if things are a bit confusing in this quite mini how to, please tell me how I can fix it to make it better.</para>
<para>Thanks!</para></sect1>
</Article>
<abstract>
<indexterm>
<primary>Abstract</primary>
</indexterm>
<para>This is a Cookbook on how to set up a Wireless Link-Sys WPC11 card using a Link-SYS Wireless Access Point/DSL/Switch on a Debian system .
</para>
</abstract>
</articleinfo>
<sect1>
<TITLE>Link-sys WPC11 install on Debian</TITLE>
<sect2>
<title>Why Debian and why just this card?</title>
<para>I have been trying for months to get wireless working on Debian and after reading far and wide and getting help from irc.debian.org, I realized that there really is no Cookbook in getting wireless set up. Thus having just done it I want to commit to 'paper' so that you all can use it and I can refer to it knowing it is safe somewhere. :)
</para>
</sect2>
<sect2><title>Required Hardware</title>
<para>By required I mean, here is what I used to get this to work, and may serve as guide to anyone who wants to know what really works.</para>
<para>
BEFW11S4- EtherFast? Wireless AP + Cable/DSL Router w/4-Port Switch. I really really like this WAP (Wireless Access Point). It is OS independent (read, linux friendly) and is configured using a browser so no need to touch Microsoft software at all, even to configure it. And if you don't know what a switch is, let me tell ya, they rock. Essentially they allow the NIC to communicate in both directions at the same time. I highly recommend one.
</para>
<para>Link-sys WPC11. I have a version 3.0 and don't recommend any thing less than a version 2.5 Cost about 80 dollars</para>
</Sect2>
<sect2><title>Software Requirements</title>
<para>
<table frame=all>
<title>Software Requirements</title>
<tgroup cols=4 align=left colsep=1 rowsep=1>
<thead>
<row>
<entry>Software</entry>
<entry>Version</entry>
<entry>URL link</entry>
<entry>notes</entry>
</row>
</thead>
<tbody>
<row>
<!-- one of (ENTRYTBL ENTRY) -->
<entry>Debian Distribution</entry>
<entry>Stable ("Woody")</entry>
<entry><ulink url="http://www.debian.org">www.debian.org</ulink></entry>
<entry>linux-2.4.19.tar, patched with patch-2.4.20-pre1.bz </entry>
</row>
<row>
<!-- one of (ENTRYTBL ENTRY) -->
<entry>Absolute Systems</entry>
<entry>0.1.14</entry>
<entry><ulink url="http://www.linux-wlan.com/linux-wlan/">Abosulte systems</ulink></entry>
<entry>Make sure you download the <emphasis>11Mbps</emphasis> version. Works for 0.1.14, erros with 0.1.15</entry>
</row>
<row>
<!-- one of (ENTRYTBL ENTRY) -->
<entry>pcmcia-source</entry>
<entry>Stable</entry>
<entry><screen>apt-get install pcmcia-source</screen></entry>
<entry><---type this</entry>
</row>
<row>
<!-- one of (ENTRYTBL ENTRY) -->
<entry>pcmcia-cs</entry>
<entry>stable</entry>
<entry><screen>apt-get install pcmcia-cs</screen></entry>
<entry><---type this</entry>
</row>
<row>
<!-- one of (ENTRYTBL ENTRY) -->
<entry>wireless-tools</entry>
<entry>Stable</entry>
<entry><screen>apt-get install wireless-tools</screen></entry>
<entry><--type this</entry>
</row>
<row>
<!-- one of (ENTRYTBL ENTRY) -->
<entry>pump</entry>
<entry>stable</entry>
<entry><screen>apt-get install pump</screen></entry>
<entry>Useful to see if card works</entry>
</row>
<row>
<!-- one of (ENTRYTBL ENTRY) -->
<entry>kernel-package</entry>
<entry>stable</entry>
<entry><screen>apt-get install kernel-package</screen></entry>
<entry>Good way to build kernel and the one I describe.</entry>
</row>
<row>
<!-- one of (ENTRYTBL ENTRY) -->
<entry>Kernel</entry>
<entry>2.4.19, patched with patch-2.4.20-pre1.bz2 </entry>
<entry><ulink url="http://www.kernel.org">www.kernel.org</ulink></entry>
<entry>You must know how to build and patch a kernel to do this. Its not hard and I will show you</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
<para>You will also need some way to setup you IP address on your wireless card, I recommend either <screen>apt-get install DHCP-client</screen> to install the DHCP-client that will automatically configure your IP address, if you have a DHCP server. The WAP-11 hardware does provide DHCP server capabilities</para>
<para>Or at least have the <emphasis>pump</emphasis> application, which also will query a DHCP server and get you an IP address from the DHCP server. Note I tend to use <emphasis>pump</emphasis> when I am trying out new hardware to see if there is a connection, since to test a particular device, say <emphasis>eth0</emphasis> I would type <screen>pump -i eth0</screen> where the option <emphasis>-i</emphasis> tells <emphasis>pump</emphasis> what device to try to get an IP address. In this particular case, when I could not get Debian to automatically set up my wireless card, which was device <emphasis>wlan0</emphasis>, I would type <screen>pump -i wlan0</screen> and <emphasis>pump</emphasis> would try to set up the device. Anyway, the point is, that it is a good trouble shooting command, and you should know about it, and I talk more about it later.</para>
<para>I also recommend you use the "kernel-package" package when you want to build your new kernel, which I will get to. This tool is very good and you should be using it anyway when you are building new kernel for the Debian distribution. You can install it by typing <screen>apt-get install kernel-package</screen> Also, be sure to read the documentation it comes with, in case I don't do a good job explaining how to use it, later in this document
</para>
</sect2>
<sect2><title>Kernel Configuration</title>
<sect3><title>What TO enable</title>
<para>In order to use the wireless tools, like <emphasis>iwconfig</emphasis>, which will allow you tell how good your connection is, you need to enable support for <emphasis>Wireless LAN (Non-Ham Rasio)</emphasis>.</para>
<para>In these examples, I use <screen>make menuconfig</screen> to configure my kernel.</para>
<para>You can do this by:</para>
<literallayout>
Go to:
Network Device support -->
then Select:
Wireless LAN (non-hamradio) --->
</literallayout>
<para>
Then Choose the options,
so that it looks like below, or something
as close to this.
Note I am uing 'make menuconfig'
to configure my kernel
</para>
<literallayout>
[*] Wireless LAN (non-hamradio)
< > STRIP (Metricom starmode radio IP)
< > AT T WaveLAN & DEC RoamAbout DS support
< > Aironet Arlan 655 & IC2200 DS support
< > Aironet 4500/4800 series adapters
< > Cisco/Aironet 34X/35X/4500/4800 ISA and PCI cards
<*> Hermes chipset 802.11b support (Orinoco/Prism2/Symbol)
< > Hermes in PLX9052 based PCI adaptor support
<*> Prism 2.5 PCI 802.11b adaptor support
</literallayout>
</sect3>
<sect3><title>What <emphasis>NOT</emphasis> to Enable</title>
<para>One of the main stumbling blocks was to realize that the <emphasis>pcmcia support in the kernel is not as good as the pcmcia-source support</emphasis> that one gets when you build it from pcmcia-source.
</para>
<para>I use either <screen>make xconfig</screen> or <screen>make menuconfig</screen> to configure my kernel, so when you configure your kernel, be sure to not have pcmcia support enabled under <screen>General setup</screen>
</para>
<para>Nor do you want to select any particular pcmcia card under <screen>Network device support</screen>. I repeat you do not want this under the kernel and you will be building it when you download pcmcia-source.</para> <caution><para>Be sure to download all the necessary components before you take pcmcia support out of the kernel, otherwise, if you were using a pcmcia card for net access, you will not be able to connect to the Internet using the new kernel, until you have built both pcmcia support and module drivers for the wireless card</para></caution>
</sect3>
</sect2>
</sect1>
<sect1>
<title>Using make-kpkg to build kernels</title>
<caution><para>Note: <emphasis>make-kpkg</emphasis> was installed when you installed <emphasis>kernel-package</emphasis></para></caution>
<para>Once you have configured your kernel just save and exit, and don't use make-kpkg yet! I will show you a good way to make sure sure everything builds well.</para>
<para>Follow the instruction in the make-kpkg documentation but essentially:</para>
<para>You need to be in the <screen>/usr/src/linux</screen> directory, then </para>
<screen>make-kpkg clean</screen>
<para>to clean all the binaries out and prepare to build a new kernel, then:</para>
<screen>make-kpkg --revision=custom.1.0 kernel_image</screen>
<caution><para>Don't Do this Yet!</para></caution>
<para>We need to get the pcmcia-source ready to be built at the same time as the kernel is built. This is a very neat feature of make-kpkg!</para>
</sect1>
<sect1><title>Building PCMCIA-SOURCE</title>
<para>First, be sure to download pcmcia-source, by typing <screen>apt-get install pcmcia-source</screen> This will download the source into <screen>/usr/src</screen> as <screen>pcmcia-source.tar.gz</screen></para>
<para>You now need to gunzip the file by <screen>gunzip pcmcia-source.tar.gz</screen> and then untar the file by <screen>tar xvf pcmcia-source.tar</screen></para>
<para>You should see pcmcia-source unpacked into the directory <screen>/usr/src/modules/pcmcia-cs</screen></para>
</sect1>
<sect1><title>Using make-kpkg to build the new kernel and pcmcia-source modules</title>
<para>Be sure the pcmcia-source is under /usr/src/modules.</para>
<para>Go ahead and configure your kernel and be sure that pcmcia support IS NOT compiled in as an option in the kernel.</para>
<para>To build the kernel and pcmcia-source, be sure you are under the <screen>/usr/src/linux</screen> or have a symbolic link from /usr/src/linux to whatever kernel source you have set up. Then type <screen>make-kpkg --revision=custom.1.0 kernel_image modules_image</screen></para>
<para>The <emphasis>kernel_image</emphasis> option will build the kernel while the <emphasis>modules_image</emphasis> option will build all modules located under <screen>/usr/src/modules/</screen>. So be sure that you do indeed want to rebuild any other modules that are located in source when you are ready to build your new kernel.</para>
<para>After some chugging, go up one level to <screen>/usr/src</screen> and you should see two new Debian packages that should look something like this:
<literallayout>
kernel-image-2.4.19-pre4_custom.1.0_i386.deb
pcmcia-modules-2.4.19-pre4_3.1.31-7+custom.1.0_i386.deb
</literallayout>
</para>
<para>You first want to install the kernel image so you would type <screen>dpkg -i kernel-image-etc....</screen></para>
<para>Now install the modules by typing <screen>dpkg -i pcmcia-modules.etc...</screen></para>
<caution><para>There are a couple of assumptions that make-kpkg makes about your lilo.conf file. One is that you have not radically changed it. Make-kpgk will make make symbolics links from '/boot' where the actual kernel resides to 'vmlinuz' which is under '/'. In other words, under '/', you will see <emphasis>vmlinuz</emphasis> and <emphasis>vmlinuz.old</emphasis> which are symbolic links to the real kernel images under <emphasis>/boot/</emphasis>. Anyway if you have any questions ask me.</para></caution>
</sect1>
<sect1><title>Wlan Drivers for You Link-Sys Card</title>
<para>You have downloaded the 11 Wlan project. Go a head and read the instruction, and put it under modules. Follow the instructions when you <screen>make config</screen> The one key is to make sure you specify the pcmcia-source as under <screen>/usr/src/modules/pcmcia-cs</screen> and not choose the default it gives you.</para>
<para>Go ahead and <screen>make all</screen> and <screen>make install</screen></para>
<para>I suggest you read the documentation that comes with it, but essentially, <emphasis>if you have a WAP that is connected to your DSL or cable modem then you have a <emphasis>infrastructure set up.</emphasis></emphasis> I found that it was best to edit the <screen>networks.opt</screen> under the <screen>/etc/pcmcia</screen> directory.</para>
<para>To make things easier edit the option
<literallayout># Use DHCP (via /sbin/dhcpcd, /sbin/dhclient, or /sbin/pump)? [y/n]
DHCP="y"</literallayout> to what I have, i.e., set it to yes.
</para>
<para>The documentation talks about setting ESSID but when you edit the <screen>wlan-ng.opts</screen> you will only see
<literallayout>
#=======INFRASTRUCTURE STATION START===================
# SSID is all we have for now
AuthType="opensystem" # opensystem | sharedkey (requires WEP)
DesiredSSID="howardnet"
</literallayout>
</para>
<para>From what I can gather,DesiredSSID means ESSID and it works when the WAP and link-sys pcmcia card share the same name.</para>
<para>At this point, you should reboot and should have a working link-sys card that gets its address via DHCP.</para>
</sect1>
<sect1><title>Checking things in case they don't work</title>
<para>1. Be sure to type <screen>ifconfig</screen></para>
<para>You should something like this</para>
<literallayout>
lo Link encap:Local Loopback
inet addr:127.0.0.1 Mask:255.0.0.0
UP LOOPBACK RUNNING MTU:16436 Metric:1
RX packets:0 errors:0 dropped:0 overruns:0 frame:0
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:0
RX bytes:0 (0.0 b) TX bytes:0 (0.0 b)
wlan0 Link encap:Ethernet HWaddr 00:06:25:A8:AE:64
inet addr:192.168.1.104 Bcast:192.168.1.255 Mask:255.255.255.0
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
RX packets:35197 errors:0 dropped:0 overruns:0 frame:0
TX packets:57676 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:100
RX bytes:43386657 (41.3 MiB) TX bytes:2670811 (2.5 MiB)
Interrupt:3 Base address:0x100
</literallayout>
<para>The keys point here are that <emphasis>inet addr:</emphasis>has a real IP address, and that <emphasis>Bcast</emphasis> and <emphasis>Netmask</emphasis> are set up such that they are on the same "wave-length" as your Wireless Access Point.</para>
<para>2. If you don't, you might have had the same problem i did which was that there was no easy script to initiate the wlan0 device setup. That is to say, if the card was recognized but you still did not get a connection and say that ifconfig showed wlan0 present but with no IP address. In other words, you might see something like this:</para>
<para><literallayout>
text:/home/dude# ifconfig
lo Link encap:Local Loopback
inet addr:127.0.0.1 Mask:255.0.0.0
UP LOOPBACK RUNNING MTU:16436 Metric:1
RX packets:14 errors:0 dropped:0 overruns:0 frame:0
TX packets:14 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:0
RX bytes:700 (700.0 b) TX bytes:700 (700.0 b)
wlan0 Link encap:Ethernet HWaddr 00:06:25:A8:AE:64
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
RX packets:1 errors:0 dropped:0 overruns:0 frame:0
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:100
RX bytes:46 (46.0 b) TX bytes:0 (0.0 b)
Interrupt:3 Base address:0x100
</literallayout></para>
<para>As you can see, the interface device, the Wireless pcmcia card, is noted, but there is no <emphasis>inet addr</emphasis>. The pcmcia software recognized the card, but it has not successfully connected with the Wireless Access Point.</para>
<para>I used the command,<emphasis>pump</emphasis> to send a simple DHCP request to the DHCP server for the device in question. I used<screen>pump -i wlan0</screen> which essentially runs a simple DHCP request to set up that card, wlan0, in this case.</para>
<para>You can get the <emphasis>pump</emphasis> by <screen>apt-get install pump</screen></para>
<para>While I needed to use <screen>pump -i wlan0</screen> on my laptop, I did not need this when I set up the link-sys wireless WPC11 card on my girlfriend's laptop. She has a Link-Sys WPC11 version 2.5 pcmcia card.</para>
</sect1>
<sect1><title>Wireless tools</title>
<para>While it is not necessary to include this in your kernel configuration, you can enable Wireless tool extensions by going (i assume you use xconfig or menuconfig) to <screen>Network device support</screen> and then go to <screen>Wireless LAN (non-hamradio)</screen> and enable support for the <screen>Hermes chipset 802.11b support (Orinoco/Prism2/Symbol)</screen>. This will let you use the Wireless Tools like <screen>iwconfig</screen>, <screen>iwspy</screen> and such.</para>
<para>The one thing I found this good for is that by repeated typing iwconfig, you can see your Link Quality. Its quite good</para>
</sect1>
<sect1>
<title>Wireless Access Point</title>
<para>Perhaps its it missing the forest for the trees, but I did not spend any discussion setting up the actual Wireless Access Point. The reason is that the documentation that comes with the WAP is well written. The only thing I haven't spoken about is enabling Wireless Encryption Protocol in the WAP (Wireless Access Point) which I really don't suggest as I don't think WEP has been properly set up in the drivers for the Pcmcia Wireless Cards. However, let me know if you have any problems and I will be glad to help.
</para>
</sect1>
<sect1><title>Request for comments</title>
<para>I will be glad to help anyone out and if things are a bit confusing in this quite mini how to, please tell me how I can fix it to make it better.</para>
<para>Thanks!</para></sect1>
</Article>