home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 May / Chip_2000-05_cd1.bin / zkuste / Perl / ActivePerl-5.6.0.613.msi / 䆊䌷䈹䈙䏵-䞅䞆䞀㡆䞃䄦䠥 / _47480a037aee1137de624f0ccc74a92a < prev    next >
Text File  |  2000-03-22  |  15KB  |  259 lines

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