.TH "HXUNENT" "1" "10 Jul 2011" "7.x" "HTML-XML-utils"
.de d \" begin display
.sp
.in +4
.nf
.ft CR
.CDS
..
.de e \" end display
.CDE
.in -4
.fi
.ft R
.sp
..
.SH "نام (NAME)"
hxunent \- جایگزینی موجودیت‌های نویسه‌ای پیش‌تعریف‌شدهٔ HTML با UTF-8
.SH "خلاصه دستور (SYNOPSIS)"
.B hxunent
.RB "[\| " \-b " \|]"
.RB "[\| " \-f " \|]"
.RI "[\| " file " \|]"
.SH "توضیحات (DESCRIPTION)"
.LP
دستور
.B hxunent
فایل ورودی
.I file
(یا ورودی استاندارد) را می‌خواند و آن را با جایگزینی موجودیت‌های با علامت & با نویسهٔ معادل آن‌ها (کدگذاری‌شده به‌صورت UTF-8) در خروجی استاندارد رونوشت می‌کند. برای نمونه، " با " و < با < جایگزین می‌شود.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های زیر پشتیبانی می‌شوند:
.TP 10
.B -b
پنج موجودیت درونی XML یعنی (< > " ' &) جایگزین نشده و بدون تغییر رونوشت می‌شوند. این امر در صورتی که لازم باشد خروجی یک XML یا SGML معتبر باشد، ضروری است.
.TP
.B -f
این گزینه نحوهٔ برخورد با موجودیت‌های ناشناخته یا علامت‌های آمپرسند تنها را تغییر می‌دهد. به‌طور معمول این موارد بدون تغییر رونوشت می‌شوند، اما این گزینه تلاش می‌کند تا با جایگزینی آمپرسندها با & آن‌ها را «اصلاح» کند. اغلب چنین آمپرسندهای سرگردانی نتیجهٔ رونوشت و جای‌گذاری URLها در یک سند هستند و سپس این گزینه در واقع آن‌ها را اصلاح کرده و سند را معتبر می‌سازد.
.SH "خطاها (DIAGNOSTICS)"
در صورتی که همه‌چیز به‌درستی پیش برود، وضعیت خروج برنامه 0 است؛ در غیر این صورت:
.TP 10
.B 1
ورودی قابل خواندن نبود (فایل یافت نشد، فایل خواندنی نبود...)
.TP
.B 2
آرگومان‌های خط فرمان نادرست است.
.SH "همچنین ببینید (SEE ALSO)"
.BR asc2xml (1),
.BR xml2asc (1),
.BR UTF-8 " (RFC 2279)"
.SH "گزارش باگ‌ها (BUGS)"
.LP
این برنامه فرض می‌کند موجودیت‌ها همان‌گونه که توسط HTML تعریف شده‌اند هستند. این برنامه DTD یک سند را برای یافتن تعاریف واقعی استفاده‌شده در سند نمی‌خواند.
همراه با
.BR \-f ،
حتی تمام موجودیت‌هایی که موجودیت HTML نباشند را نیز حذف خواهد کرد.