home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 5 Edit / 05-Edit.zip / txpdf56.zip / contributed / OpenVMS / README next >
Text File  |  2001-11-01  |  2KB  |  47 lines
  1. TXT2PDF.COM is a short DCL procedure to interface with the script
  2. (replacement for #!/usr/bin/perl in Unix) :
  3.  
  4.     Actually, the safest TXT2PDF.COM would be like this
  5.  
  6. $ INSTALL_DIR   = F$PARSE(F$ENVIRONMENT("PROCEDURE"),,,,"NO_CONCEAL")-"]["
  7. $ INSTALL_DIR   =F$EXTRACT(0,F$LOCATE("]",INSTALL_DIR)+1,INSTALL_DIR)-".000000"
  8. $ perl 'INSTALL_DIR'TXT2PDF.; 'p1' 'p2' 'p3' 'p4' 'p5' 'p6' 'p7' 'p8' !
  9.  
  10.     Safest because : usage of NO_CONCEAL and -"][" prevents from 
  11. screw up in case of multiply chained VMS logicals definitions. Usage of 
  12. -".000000" is added to support installation in perl_root:[000000] a very 
  13. common directory for perl script installation. The ultimate would be to 
  14. use the wrapper I have previously sent (but that would require a make 
  15. file which appends to an OS-dependant wrapper the perl script.)
  16.  
  17.         The POD documentation is really the best for distributing a
  18.         perl-based help. 
  19.  
  20.         pod2man txt2pdf.pod >txt2pdf.man
  21.         pod2html txt2pdf.pod >txt2pdf.html
  22.         pod2hlp txt2pdf.pod 
  23.  
  24.     The last command can be be used only if the POD2HLP.PM from Dan 
  25. Susgalski is installed (on the Perl module archive). pod2man usually 
  26.  
  27. comes with perl distribution, perl2html has been added in recent versions 
  28. of perl.
  29.  
  30.     User may include the generated TXT2PDF.HLP in the Help library
  31. (either LIBRARY/REPLACE SYS$HELP:HELPLIB.HLB TXT2PDF.HLP 
  32. or any suitable library for "freeware").
  33.  
  34. Multiuser Features 
  35.  
  36. A system manager can install txt2pdf and provide a default .cfg file for his
  37. users/organization
  38.  
  39. define/system TXT2PDF wherever:default.cfg       VMS in SYLOGIN.COM for example
  40.  
  41. A user can still overwrite the value using another setenv or define command in
  42. his own .cshrc/login.com if he wants to have a default file of his own.
  43. A user can still have a working directory with a txt2pdf.cfg file and have it
  44. loaded if exists. This allows him (without command line option) to setup fully
  45. functional working directories.
  46. He can also (as he wishes) use the -configure option to overwrite any defaults.
  47.