perl-docs-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From s...@apache.org
Subject cvs commit: modperl-docs/src/docs/2.0/user/troubleshooting troubleshooting.pod
Date Mon, 08 Nov 2004 23:06:41 GMT
stas        2004/11/08 15:06:41

  Modified:    src/docs/2.0/user/troubleshooting troubleshooting.pod
  Log:
  document the issue with BOMs
  
  Revision  Changes    Path
  1.30      +41 -0     modperl-docs/src/docs/2.0/user/troubleshooting/troubleshooting.pod
  
  Index: troubleshooting.pod
  ===================================================================
  RCS file: /home/cvs/modperl-docs/src/docs/2.0/user/troubleshooting/troubleshooting.pod,v
  retrieving revision 1.29
  retrieving revision 1.30
  diff -u -u -r1.29 -r1.30
  --- troubleshooting.pod	4 Nov 2004 03:41:20 -0000	1.29
  +++ troubleshooting.pod	8 Nov 2004 23:06:41 -0000	1.30
  @@ -315,6 +315,47 @@
   
   
   
  +=head2 Registry scripts fail to load with: Unrecognized character \xEF at ...
  +
  +Certain editors (in particular on win32) may add a UTF-8 Byte Order
  +Marker (BOM: http://www.unicode.org/faq/utf_bom.html#BOM) at the
  +beginning of the file. Since
  +C<L<ModPerl::RegistryCooker|docs::2.0::api::ModPerl::RegistryCooker>>
  +adds extra code in front of the original script, before compiling it,
  +it creates a situation where BOM appears past the beginning of the
  +file, which is why the error:
  +
  +  Unrecognized character \xEF at ...
  +
  +is thrown by Perl.
  +
  +The simplest solution is to configure your editor to not add BOMs (or
  +switch to another editor which allows you to do that).
  +
  +You could also subclass
  +C<L<ModPerl::RegistryCooker|docs::2.0::api::ModPerl::RegistryCooker>>
  +or its existing subclasses to try to remove BOM in
  +ModPerl::RegistryCooker::read_script():
  +
  +    # remove BOM
  +    ${$self->{CODE}} =~ s/^(?:
  +        \xef\xbb\xbf     |
  +        \xfe\xff         |
  +        \xff\xfe         |
  +        \x00\x00\xfe\xff |
  +        \xff\xfe\x00\x00
  +    )//x;
  +
  +but do you really want to add an overhead of this operation multiple
  +times, when you could just change the source file once? Probably
  +not. It was also reported that on win32 the above s/// doesn't work.
  +
  +
  +
  +
  +
  +
  +
   
   
   =head1 Runtime
  
  
  

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-cvs-unsubscribe@perl.apache.org
For additional commands, e-mail: docs-cvs-help@perl.apache.org


Mime
View raw message