professional perl programming wrox 2001 phần 7

sẽ tạo ra một danh sách các vấn đề, mà sau đó chúng tôi có thể đi và sửa chữa, ví dụ: *** Chú ý: tập tin không bắt đầu với = đầu tại dòng N tập tin cảnh báo này chỉ ra rằng chúng ta đã bắt đầu tài liệu pod với một cái gì đó khác hơn là a = head1 hoặc = head2, kiểm tra xem xét sẽ là nghi ngờ. | Text Processing and Document Generation Simpo PDF Merge and Split Unregistered Version - http If all is well then it will return pod syntax OK. Otherwise it will produce a list of problems which we can then go and fix for example WARNING file does not start with head at line N in file This warning indicates that we have started pod documentation with something other than a head1 or head2 which the checker considers to be suspect. Likewise WARNING No numeric argument for over at line N in file WARNING No items in over at line 17 back list at line N in file This indicates that we have an over. back pair which not only does not have a number after the over but does not even contain any items. The first is probably an omission. The second indicates that we might have bunched up our items so they all run into the over token like this over item item one item item two back If we had left out the space before the back we would instead have got ERROR over on line N without closing back at line EOF in file In short podchecker is a useful tool and we should use it if we plan to write pod of any size in our Perl scripts. The module that implements podchecker is called Pod Checker and we can use it with either filenames or file handles supplied for the first two arguments function syntax ok podchecker podfile checklog options object syntax V checker new Pod Checker options checker- parse_from_file podpath checklog Both file arguments can be either filenames or filehandles. By default the pod file defaults to STDIN and the check log to STDERR so a very simple checker script could be use Pod Checker print podchecker OK Fail The options hash if supplied allows one option to be defined enable or disable the printing of warnings. The default is on so we can get a verification check without a report using STDIN and STDERR ok podchecker STDIN STDERR warnings 0 The actual podchecker script is .