aboutsummaryrefslogtreecommitdiff
path: root/textproc/p5-XML-LibXML-PrettyPrint/pkg-descr
diff options
context:
space:
mode:
authorSunpoet Po-Chuan Hsieh <sunpoet@FreeBSD.org>2011-11-05 17:09:54 +0000
committerSunpoet Po-Chuan Hsieh <sunpoet@FreeBSD.org>2011-11-05 17:09:54 +0000
commit7183655863c4edeed8151decc38e231fae155b6d (patch)
treecb456f659267cf5a4a7cc33a93808400a3f37b37 /textproc/p5-XML-LibXML-PrettyPrint/pkg-descr
parent2ce578fdcf1e9f7c7e98cf545b4a79eaf4f3063a (diff)
downloadports-7183655863c4edeed8151decc38e231fae155b6d.tar.gz
ports-7183655863c4edeed8151decc38e231fae155b6d.zip
Notes
Diffstat (limited to 'textproc/p5-XML-LibXML-PrettyPrint/pkg-descr')
-rw-r--r--textproc/p5-XML-LibXML-PrettyPrint/pkg-descr15
1 files changed, 15 insertions, 0 deletions
diff --git a/textproc/p5-XML-LibXML-PrettyPrint/pkg-descr b/textproc/p5-XML-LibXML-PrettyPrint/pkg-descr
new file mode 100644
index 000000000000..f5135b212205
--- /dev/null
+++ b/textproc/p5-XML-LibXML-PrettyPrint/pkg-descr
@@ -0,0 +1,15 @@
+Long XML files can be daunting for humans to read. Of course, XML is really
+designed for computers to read - not people - but there are times when mere
+mortals do need to read and edit XML by hand. For example, if your application
+stores its configuration in XML, or you need to dump some XML to STDOUT for
+debugging purposes.
+
+Syntax highlighting helps, but to really make sense of some XML, proper
+indentation can be vital. Hence XML::LibXML::PrettyPrint - it can be applied to
+an XML::LibXML DOM tree to reformat it into a more readable result.
+
+Pretty-printing XML is not as CPU-efficient as dumping it out sloppily, so
+unless you're pretty sure that a human is going to need to make sense of your
+XML, you should probably not use this module.
+
+WWW: http://search.cpan.org/dist/XML-LibXML-PrettyPrint/