home *** CD-ROM | disk | FTP | other *** search
/ Australian Personal Computer 2004 July / APC0407D2.iso / workshop / apache / files / ActivePerl-5.6.1.638-MSWin32-x86.msi / _3dd20a7e66af1e8948c73c71a7ee7ba8 < prev    next >
Encoding:
Text File  |  2004-04-13  |  15.0 KB  |  301 lines

  1. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
  2. <html>
  3.  
  4. <head>
  5. <title>ActivePerl FAQ - Documentation and Support</title>
  6. <link rel="STYLESHEET" href="../Active.css" type="text/css" media="screen">
  7. </head>
  8.  
  9. <body>
  10.  
  11. <table width="100%" border="0" cellspacing="0" cellpadding="0" bgcolor="#EAE2BB">
  12. <tr> 
  13. <td width="57"><a target=_blank href="http://www.ActiveState.com/ActivePerl/">
  14. <img src="../images/activeperl_logo.gif" width="57" height="48" border="0" alt="ActivePerl"></a></td>
  15. <td><div align="center" class="heading">ActivePerl User Guide</div></td>
  16. <td width="112"><a target=_blank  href="http://www.ActiveState.com">
  17. <img src="../images/AS_logo.gif" width="112" height="48" border="0"  alt="ActiveState" /></a></td>
  18. </tr>
  19. <tr>
  20. <td class="lineColour" colspan="3"></td>
  21. </tr>
  22. </table>
  23.  
  24. <h1>Documentation and Support</h1>
  25.  
  26. <ul>
  27.   <li><a class="doc" href="#NAME">NAME</a></li>
  28.   <li><a class="doc" href="#DESCRIPTION">DESCRIPTION</a>
  29.     <ul>
  30.       <li><a class="doc" href="#Where_can_I_get_documentation_on">Where can I get
  31.         documentation on ActivePerl?</a></li>
  32.       <li><a class="doc" href="#What_kind_of_documentation_comes">What kind of documentation
  33.         comes with ActivePerl?</a></li>
  34.       <li><a class="doc" href="#Is_there_formal_support_for_Perl">Is there formal support
  35.         for ActivePerl or PerlIS?</a></li>
  36.       <li><a class="doc" href="#Are_there_information_sources_av">Are there information
  37.         sources available on ActivePerl on</a></li>
  38.       <li><a class="doc" href="#Is_there_a_mailing_list_for_Perl">Is there a mailing list
  39.         for ActivePerl or Perl for ISAPI?</a></li>
  40.       <li><a class="doc" href="#Is_there_a_Usenet_newsgroup_devo">Is there a Usenet
  41.         newsgroup devoted to ActivePerl?</a></li>
  42.       <li><a class="doc" href="#Is_there_a_FAQ_for_Perl_for_Win3">Is there a FAQ for
  43.         ActivePerl?</a></li>
  44.       <li><a class="doc" href="#How_do_I_report_a_bug_in_Perl_fo">How do I report a bug in
  45.         ActivePerl?</a></li>
  46.       <li><a class="doc" href="#Can_I_ask_a_question_or_">Can I ask a question? ... or ...
  47.         How do I ask a question?</a></li>
  48.       <li><a class="doc" href="#Are_there_any_live_chats_where_I">Are there any live chats
  49.         where I can talk about Perl stuff?</a></li>
  50.     </ul>
  51.   </li>
  52.   <li><a class="doc" href="#AUTHOR_AND_COPYRIGHT">AUTHOR AND COPYRIGHT</a></li>
  53. </ul>
  54.  
  55. <h2><a name="NAME">NAME</a></h2>
  56. <p>Documentation and Support</p>
  57.  
  58. <h2><a name="DESCRIPTION">DESCRIPTION</a></h2>
  59. <p>ActivePerl Documentation and Support</p>
  60.  
  61. <h2><a name="Where_can_I_get_documentation_on">Where can I get documentation on
  62. ActivePerl?</a></h2>
  63. <p>Documentation for ActivePerl is provided in HTML format in the <em>Html</em>
  64. directory in your <em>perl</em> directory. This has the documentation from the
  65. standard perl distribution, as well as the complete documentation for modules
  66. and extensions. For more information on Win32-specific extensions, see <a class="doc" href="Windows/ActivePerl-Winfaq9.html#What_modules_come_with_the_Perl_">What
  67. modules come with the ActivePerl distribution?</a>.</p>
  68. <p>Note that the standard perl distribution documentation (<em>perl*.html</em>)
  69. has some UNIX-specific information, and lists some features/functions that will
  70. not work on the Windows version of ActivePerl. The perlwin32 and perlport pages
  71. discuss the portability issues under the Win32 platform.</p>
  72. <p>You can also read the Perl documentation with the perldoc command. At the
  73. command prompt, type perldoc followed by the name of the document you want to
  74. read, as in:</p>
  75. <pre>
  76.     perldoc perlwin32
  77.     perldoc perlfaq
  78. </pre>
  79. <p>Documentation is provided in the binary distributions (it is created during
  80. install), and can be created by install or it can be made by "make
  81. installhtml" in the source distribution.</p>
  82.  
  83. <h2><a name="What_kind_of_documentation_comes">What kind of documentation comes
  84. with ActivePerl?</a></h2>
  85. <p>ActivePerl comes with the standard Perl documentation, as well as
  86. documentation for all Core modules.</p>
  87.  
  88. <h2><a name="Is_there_formal_support_for_Perl">Is there formal support for
  89. ActivePerl or PerlIS?</a></h2>
  90. <p>Peer support is available from the Perl-related mailing lists that
  91. ActiveState hosts. You can find more information on these mailing lists at <a class="doc" href="http://www.ActiveState.com/support/">http://www.ActiveState.com/support/</a></p>
  92. <p>Support for applications and internals is available through customized
  93. professional services.  Contact us at <a class="doc" href="http://www.ActiveState.com/Professional_Services">http://www.ActiveState.com/Professional_Services</a> for a quotation.</p>
  94. <p><a class="doc" href="http://www.ActiveState.com/Products/PerlDirect/index.html">PerlDirect</a>
  95. offers corporate support solutions for Perl. PerlDirect provides the
  96. comprehensive support that an enterprise needs to deploy Perl. </p>
  97.  
  98. <h2><a name="Are_there_information_sources_av">Are there information sources
  99. available on ActivePerl on the World Wide Web?</a></h2>
  100. <p>There are several web pages devoted to ActivePerl. Here is a short listing:</p>
  101. <ul>
  102.   <li>
  103.     <p><a class="doc" href="http://www.ActiveState.com/">http://www.ActiveState.com/</a> -
  104.     The ActivePerl home page.</p>
  105.   </li>
  106.   <li>
  107.     <p><a class="doc" href="http://www.ActiveState.com/support/">http://www.ActiveState.com/support</a>
  108.     - Introductory information, FAQs, mailing lists, and more.</p>
  109.   </li>
  110.   <li>
  111.     <p><a class="doc" href="http://dada.perl.it/">http://dada.perl.it/</a> - Aldo Calpini's
  112.     page, which includes many links, modules for Win32, and more.</p>
  113.   </li>
  114.   <li>
  115.     <p><a class="doc" href="http://www.geocities.com/SiliconValley/Park/8312/">http://www.geocities.com/SiliconValley/Park/8312/</a>
  116.     - Robin Chatterjee's Perl for Win32 page, which includes FAQs, links, etc.</p>
  117.   </li>
  118.   <li>
  119.     <p><a class="doc" href="http://www.northbound-train.com/perlwin32.html">http://www.northbound-train.com/perlwin32.html</a>
  120.     - Joe's Perl for Win32 Page, which has general information, pointers to
  121.     modules, etc.</p>
  122.   </li>
  123. </ul>
  124.  
  125. <h2><a name="Is_there_a_mailing_list_for_Perl">Is there a mailing list for
  126. ActivePerl or Perl for ISAPI?</a></h2>
  127. <p>ActiveState hosts a variety of mailing lists for the ActivePerl community.
  128. More information can be found at <a class="doc" href="http://www.ActiveState.com/support/mailing_lists.htm">http://www.ActiveState.com/support/mailing_lists.htm</a></p>
  129. <p>Archives of the mailing lists can also be found on the ActiveState web site.</p>
  130. <p>You should check the archives or a FAQ like this (see <a class="doc" href="#Is_there_a_FAQ_for_Perl_for_Win3">Is
  131. there a FAQ for ActivePerl?</a>) before posting a question to the mailing list.
  132. List members are mostly overworked programmers and admins like yourself. So, for
  133. best results, be courteous, specific, and show that you really have tried to
  134. figure out your problems for yourself.</p>
  135.  
  136. <h2><a name="Is_there_a_Usenet_newsgroup_devo">Is there a Usenet newsgroup
  137. devoted to ActivePerl issues?</a></h2>
  138. <p>Not yet. You can use comp.lang.perl.misc for miscellaneous Perl questions;
  139. the members of most Usenet Perl newsgroups tend to concentrate on UNIX
  140. platforms.</p>
  141. <p>Try the perl-win32-users mailing list (see <a class="doc" href="#Is_there_a_mailing_list_for_Perl">Is
  142. there a mailing list for ActivePerl or PerlIS?</a>) for more specific Win32
  143. information.</p>
  144. <p>For web server setup and CGI programming, try one of the following three
  145. newsgroups:</p>
  146. <pre>
  147.     comp.infosystems.www.servers.ms-windows
  148.     comp.infosystems.www.authoring.cgi
  149.     comp.infosystems.www.authoring.misc
  150. </pre>
  151.  
  152. <h2><a name="Is_there_a_FAQ_for_Perl_for_Win3">Is there a FAQ for ActivePerl?</a></h2>
  153. <p>You are reading one of them. Also, Perl is shipped with the main PerlFAQ
  154. inside the help system, which is over a hundred pages long and split into
  155. several parts.</p>
  156. <p>Robin Chatterjee's Perl for Win32 page contains frequently asked questions
  157. and copies of the perl-win32-users mailing list responses to them:</p>
  158. <pre>
  159.     <a class="doc" href="http://www.geocities.com/SiliconValley/Park/8312/">http://www.geocities.com/SiliconValley/Park/8312/</a>
  160. </pre>
  161.  
  162. <h2><a name="How_do_I_report_a_bug_in_Perl_fo">How do I report a bug in
  163. ActivePerl?</a></h2>
  164. <p>The ActiveState bug reporting system can be found at <a class="doc" href="http://bugs.ActiveState.com">http://bugs.ActiveState.com</a></p>
  165. <p>Before you report a bug to this location, you need to do several things:</p>
  166. <ul>
  167.   <li>
  168.     <p>Make sure it's a real bug, and not a logic error in your program.</p>
  169.   </li>
  170.   <li>
  171.     <p>Make sure it's a real bug, and not just a misunderstanding about how Perl
  172.     works. Check the mailing list archives and FAQs, so you can see if someone
  173.     else has come across this problem. ALWAYS do this first, even if you are
  174.     otherwise certain that it is a real bug. Most bugs reported to ActiveState
  175.     are not bugs and could be solved by looking through the list archives or
  176.     FAQs.</p>
  177.   </li>
  178.   <li>
  179.     <p>You can also use http://groups.google.com/ to search comp.lang.perl.misc. If this
  180.     is a problem that has been discussed in the newsgroup, your answer may be
  181.     there. After exhausting these possibilities, you may want to post to one of
  182.     the mailing lists to see if other people might have an answer. See also 
  183.     <a class="doc" href="#Can_I_ask_a_question_or_">Can
  184.     I ask a question? ... or ... How do I ask a question</a>?</p>
  185.   </li>
  186.   <li>
  187.     <p>You should check the bug list to see if your bug has already been
  188.     reported or fixed.</p>
  189.   </li>
  190.   <li>
  191.     <p>You need to be able to reproduce the bug. If it just happens once, then
  192.     it is not a bug. This needs to be clear: if it can't be repeated then it is
  193.     not a bug.</p>
  194.   </li>
  195.   <li>
  196.     <p>Create a short, simple script as an example of the bug. Do not send the
  197.     original source code as your example - do what you can to reduce the example
  198.     to the smallest possible case. This process has been known to reveal errors
  199.     that have been cleverly masquerading as bugs.</p>
  200.   </li>
  201.   <li>
  202.     <p>It should not be necessary to do much setup for ActiveState bug testers
  203.     to reproduce your bug. If setup or example data files are required, prepare
  204.     simple instructions.</p>
  205.   </li>
  206.   <li>
  207.     <p>Once all this is done, you should send your bug report to ActiveState,
  208.     stating clearly the nature of the bug, how to reproduce it, and what
  209.     platform, operating system, and perl version is causing the problem.
  210.     Remember that your goal is to give ActiveState enough information to
  211.     reproduce the bug. If it is not reproducible, it can't be considered a bug.</p>
  212.   </li>
  213.   <li>
  214.     <p>You should get email about the status of your bug as it goes through the
  215.     process of verification and fixing.</p>
  216.   </li>
  217.   <li>
  218.     <p>Do not submit the same bug more than once.</p>
  219.     <p><a class="doc" href="http://bugs.ActiveState.com">Submit bugs here</a>.</p>
  220.   </li>
  221. </ul>
  222.  
  223. <h2><a name="Can_I_ask_a_question_or_">Can I ask a question? ... or ... How do I
  224. ask a question?</a></h2>
  225. <p>The etiquette for asking questions is about the same whether you're working
  226. with mailing lists, newsgroups, chatrooms, or IRC channels. Here are some
  227. pointers that will help you get your questions answered.</p>
  228. <ul>
  229.   <li>
  230.     <p>Do your own study before you ask a question. Buy a book (or more than
  231.     one... O'Reilly has lots to choose from), read the online help, and search
  232.     the web for yourself. If you don't have time to try to find find the answer
  233.     yourself, these folks won't have time to answer you.</p>
  234.   </li>
  235.   <li>
  236.     <p>Check the FAQ first - if the question has already been answered in the
  237.     FAQ, you may not get an answer to it if you ask it in a public forum.</p>
  238.   </li>
  239.   <li>
  240.     <p>Never ask, "Can I ask a question?", because that is a sure sign
  241.     that the person doing the asking is a newbie. People on IRC and newsgroups
  242.     get bored with newbies because they always seem to ask and never seem to do
  243.     their own study.</p>
  244.   </li>
  245.   <li>
  246.     <p>Read the mailing list or newsgroup for a while before you ask a question.
  247.     If you need to ask a question immediately, and you've never read the
  248.     newsgroup or mailing list, read the mailing list archives or use
  249.     http://groups.google.com/ to read old messages posted to the newsgroup. This will
  250.     familiarize you with the way people ask questions in the particular
  251.     newsgroup or mailing list you want to post to. If your question has come up
  252.     before, there is a good chance it has been answered before - the newsgroup
  253.     or mailing list archives will turn up these answers if you search them
  254.     carefully.</p>
  255.   </li>
  256.   <li>
  257.     <p>Ask your question directly. Plan your question beforehand, then just come
  258.     right out and ask it. It might seem rude just to blurt out a question like
  259.     that, but it's the way it's done.</p>
  260.   </li>
  261. </ul>
  262.  
  263. <h2><a name="Are_there_any_live_chats_where_I">Are there any live chats where I
  264. can talk about Perl stuff?</a></h2>
  265. <p>For UNIX or more general perl programming discussion, you can try out <code>#perl</code>
  266. on EFNet (the big one) and UnderNet. Be careful of EFNet <code>#perl</code>
  267. though. There are a number of discussion topics that are not tolerated there:
  268. Win32-specific Perl issues, non-programmer questions (e.g., I just downloaded
  269. this neat script - how do I make it work?), and CGI/WWW programming. EFNet <code>#perl</code>
  270. is a good place to meet some Perl masters, however, like Tom Christiansen
  271. (tchrist) and Randall Schwartz (q[merlyn]). I've never seen Larry on there but
  272. I'm told he does come on from time to time.</p>
  273. <p>In any of these IRC channels, you need to do your own work, and try to solve
  274. your own problems. Don't go in expecting someone to look over some neat script
  275. you downloaded and want to get working if you "just want it to work and
  276. don't have time to learn perl". That kind of attitude is an easy way to get
  277. banned from the channel. The members of these channels are overworked Perl
  278. programmers with little tolerance for people who want others to do their work
  279. for them.</p>
  280. <p>After you ask a question, you should stick around and chat for a while. It's
  281. polite, and a very good way to learn "perl style", or how perl
  282. programmers think about everyday things.</p>
  283.  
  284. <h2><a name="AUTHOR_AND_COPYRIGHT">AUTHOR AND COPYRIGHT</a></h2>
  285. <p>This FAQ was originally assembled and maintained by Evangelo Prodromou. It
  286. has been revised and updated by Brian Jepson of O'Reilly & Associates, David
  287. Grove, David Dmytryshyn and David Sparks of ActiveState.</p>
  288. <p>This FAQ is in the public domain. If you use it, however, please ensure that
  289. you give credit to the original authors.</p>
  290. <table border="0" cellpadding="0" cellspacing="0" width="100%">
  291.   <tr>
  292.     <td class="block" valign="MIDDLE" width="100%" bgcolor="#cccccc"><strong>
  293.       <p class="block"> ActivePerl FAQ - Documentation and Support</p>
  294.       </strong></td>
  295.   </tr>
  296. </table>
  297.  
  298. </body>
  299.  
  300. </html>
  301.