home *** CD-ROM | disk | FTP | other *** search
/ PC World 1999 April / PCWorld_1999-04_cd.bin / Software / TemaCD / 14all / perl.txt < prev    next >
Text File  |  1998-02-21  |  3KB  |  93 lines
  1. Perl support in 1-4-All
  2. *~*~*~*~*~*~*~*~*~*~*~*
  3.  
  4. Perl support is in beta stage and disabled as default.
  5. To enable it, rename the file "perlwords.da_" to 
  6. "perlworlds.dat". Do not edit this file! 
  7. (Re)Start 1-4-All.
  8.  
  9. I suggest to enable 1-4-All's backup option while the 
  10. perl support is in beta stage.
  11.  
  12. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  13. If you enable perl support, please take the time to
  14. report all problems to support@mmsoftware.com. Thanks!
  15. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  16.  
  17.  
  18. *** General info:
  19. When you open a perl file (.pl or .cgi extension) you 
  20. will get a new main menu entry "Perl" and the file will
  21. be color coded to Perl syntax.
  22.  
  23.  
  24. *** Executing scripts:
  25. (Was tested with Perl for Win32 Build 306 (Perl 5.003_07),
  26. but should work with other versions. Let me know if not.)
  27.  
  28. If you have Perl installed on your machine, you can 
  29. execute the current script and redirect the output to 
  30. 1-4-All's message frame, it's internal or one of the 
  31. external browsers.
  32.  
  33. Select "Perl|Execute" and enter all options and paramters to
  34. pass. Select "Perl|Execute again" to run the current script 
  35. with the previously used options and parameters.
  36.  
  37. If you select to redirect the output to 1-4-All's message 
  38. frame and a line of output refers to a line in the script, 
  39. you can double-click in the message frame to jump to that 
  40. line in the script.
  41.  
  42. On execution a copy of the current script is saved with 
  43. the ".tmp" extension and this copy is actually executed, not
  44. the original file.
  45.  
  46.  
  47. *** Passing parameters by ENV parameters:
  48. Perl scripts used on the WWW get their parameters through
  49. ENV variables, defined in the CGI specification, and NOT
  50. by the command line. 
  51.  
  52. To find out more about CGI and defined ENV variables, see:
  53.  
  54. http://hoohoo.ncsa.uiuc.edu/cgi/
  55. http://hoohoo.ncsa.uiuc.edu/cgi/interface.html
  56.  
  57. A script that simply shows all ENV variables passed from 
  58. your browser can be found at:
  59.  
  60. http://hoohoo.ncsa.uiuc.edu/cgi-bin/test-cgi/extra/path?a+query
  61.  
  62. To pass ENV parameters to your script, select "Perl|Execute", 
  63. click on "ENV paramters" and enter all ENV parameters your 
  64. perl script needs.
  65.  
  66. The ENViroment paramter QUERY_STRING starts without the 
  67. question mark seen in URLs, e.g. in the URL (I made that up...)
  68.  
  69. "http://www.cooking.com/cgi/recipesearch.pl?term=onions&maxhits=30"
  70.  
  71. QUERY_STRING is set to "term=onions&maxhits=30" and that's what 
  72. you would enter in the QUERY_STRING field of the "Execute perl 
  73. script" window.
  74.  
  75. How are the ENV values actually passed you ask? Open the 
  76. <scriptname>.tmp file that is created for execution (and deleted 
  77. when 1-4-All is closed) and examine the code. Note the call to
  78. the subroutine in the first line and examine the subroutine at 
  79. the end of the file. Cheap trick...
  80.  
  81.  
  82.  
  83. *** Passing parameters by command line:
  84. If you select to pass parameters by the command line, 
  85. 1-4-All will execute:
  86.  
  87. <Path_to_perl> -s <scriptname> -<your_parameters>
  88.  
  89. e.g.:
  90.  
  91. C:\Perl\bin\Perl.exe -s myscript.tmp -color1=green
  92.  
  93. *EOF*