FUNCTIONS:

8-Bit-ASCII to 7-Bit-ASCII and inverse via

 - Character-Entity-Codes used in HTML
 - Character-Entity-Names used in HTML
 - (or your own definitions)

8-Bit-ASCII to 7-Bit-ASCII via

 - Umlaute
 - (or your own definitions)

8-Bit-ASCII to 8-Bit-ASCII (via datafile) and inverse via

 - MSDOS-ASCII
 - Macintosh-ASCII
 - (or your own definitions)

HTML-COLOR-CODES to HTML-COLOR-NAMES and inverse via

 - HTML 3.2 COLOR-NAMES
 - NETSCAPE COLOR-NAMES
 - COLOR-CODES


This  program  is  usefull  for  HTML-Developers  and  can  also be used for
Internet-,  Compuserve-, FIDO-, ZCONNECT-Newsgroups and eMails.  It supports
the ability to convert 8Bit-characters into 7Bit-characters and reverse with
the  help  of  character-entity-codes  or  -names or alternative characters.
Additionaly   it   can  convert  HTML  3.2-  and  Netscape-color-names  into
color-codes and reverse.

This program is written in 100% assembly language for the Motorola MC68000.
It runs on every AmigaOS 2.0 and higher.

A GUI is not implemented at this moment, but an ARrexx-Script adds this
program into Cygnus ED's Interface.



Files: Raw2Ent               1.9s  (13.03.98)
       Raw2Ent.ced           1.01  (26.12.96)
       Raw2Ent.doc           english documentation
       Raw2Ent.dok           german documentation
       Raw2Ent.rexx          1.4.1 (14.07.96)
       Raw2Ent.rexx.old      1.3.4 (01.11.96)
       Raw2EntCheck          1.0   (12.12.96)
       Raw2EntHTMLColors.iff HTML 3.2-Color-Names, -Codes and -Colors
       Raw2EntLogic.asc      logical-structure documentation
       Raw2EntMeta.asc       meta-structure documentation
       Raw2EntTables.doc     code-tables documentation
       Template.r2e          a table-template for you
       Umlaute.r2e           the Umlaut-table as a template for you
       MAC.r2e               the Macintosh-ASCII-definition
       MSDOS.r2e             the MSDOS-ASCII-definition



WHAT'S NEW SINCE LAST RELEASE?
	- Total Bug-Fix for 68000er computers!
	- HTML-Documentation

WHAT'S NEW SINCE RELEASE 1.8?
	- DATA-Mode allows you to define your own convertion-table
	- convertion-tables included into package
	- standard-output feature included. Now it's possible to
		a) preview the output in the console
		b) append the source to destination (with ">>" (see AmigaDOS))
		c) dircetly print the output etc. (with ">prt:" ("))


FAST INTRODUCTION: (see below for a larger introduction)
Raw2Ent can convert

8Bit-ASCII (ISO-8859-1 [Amiga]) -> 7Bit-ASCII with Character-Entity-Codes
example:            "Hallöchen" -> "Hallöchen"

   7Bit-ASCII with Entity-Codes -> 8Bit-ASCII (ISO-8859-1 [Amiga])
example:         Hallöchen -> Hallöchen

8Bit-ASCII (ISO-8859-1 [Amiga]) -> 7Bit-ASCII with alternative characters
example:            "Hallöchen" -> "Halloechen"

HTML32- or NETSCAPE-COLOR-NAMES -> HTML-Color-Codes
example:          BGCOLOR="Red" -> BGCOLOR="#FF0000"

               HTML-Color-Codes -> HTML32- or NETSCAPE-COLOR-NAMES
example:      BGCOLOR="#FF0000" -> BGCOLOR="Red"


Additionally  you  can  define your own convertion-table.  Tables for MSDOS-
and MACINTOSH-ASCII are included into the package.



INTRODUCTION

Raw2Ent   converts   raw   8-Bit-ASCII-Text   into   7-Bit-ASCII-Text   with
entity-codes  and  reverse.   The  ASCII-Format is a standardized format for
information  interchange,  but it is only standardized seven-bit-wide, which
means  that  128 codes are defined.  One Byte consists of eight bits and can
represent  256  different  bit  combinations.   Therefore  the  last 128 bit
combinations  are defined for free use by any operation-system.  The problem
is that accent-characters and other special characters are not standardized,
because  they  are defined in (guess where?!  ;) ) the free part of ASCII by
the operation system developers.

The  goal of the Wold Wide Web developers was that it could be used on every
important   operation   system.   So  it  was  clear  that  the  ASCII-Based
HTML-Source-Code   had  to  use  the  standardized  seven-bit  area  of  the
ASCII-Code.  To represent accent-characters or other special characters in a
seven-bit-code,  it  was  neccesary  to  invent something.  And this was the
entity-code  -  a  kind  of  escape-code.   An  entity-code  consists  of an
introducing  "&"  and  a  ";"  at  the  end.   Between  these  symbols  is a
character-name the browser can interpret.  It is a very hard and stupid work
to convert the ASCII-Text by hand.  So just use Raw2Ent!

Raw2Ent  produces  real 7-Bit-ASCII-Code.  All printable Amiga-characters in
the  8-bit-area  will be converted into entity-codes, without any exception.
The  use  of names instead of code-numbers will make the entity-codes easier
to be read by humans.  If no name was defined in the HTML 3.2 reference, the
code-number will be used.

You  can use Raw2Ent also to check, wether your file contains pure seven-bit
codes  or  not.   If  not,  Raw2Ent  will  present  you  the position of the
8-Bit-Characters in the text.

Raw2Ent can also handle color-codes and -names.



                             //             \\
                           \X/ Amiga ForEVER \X/

GRÜSSE !!!

Ich grüße alle verbliebenen Amiga-Benutzer!

Ich   bin  davon  überzeugt,  daß  Amiga  mehr  und  mehr  an  Bedeutung  im
Computersektor  gewinnen  wird.  Wir können doch nicht zulassen, daß wir als
MultiMedia-Pioniere  den  ewigen  Nachzüglern das Feld freilassen!  Der Witz
ist  ja,  daß  viele  Features des Amigas immer noch nicht von PC's erreicht
wurden.   PC's  konnten ja nur deshalb in den Multimedia-Bereich vordringen,
weil  die  DOSen  mit  immer  mehr  Power  vollgestopft wurden und nicht mit
innovativen Technologien und Konzepten.  Amigas sind nach wie vor die einzig
wahren  Multimedia-Rechner.  Und die fehlende Power wird Amiga International
hoffentlich  bald  beseitigen  und  vielleicht noch mehr innovative Konzepte
realisieren.

                             //             \\
                           \X/ Amiga ForEVER \X/



SEND COMMENTS TO:

Tamio Patrick Honma

eMail: honma@uni-duesseldorf.de
  WWW: http://www-public.rz.uni-duesseldorf.de/~honma/

                      *>> Love all over the world! <<*




----------------------------------------------------------------------------
                               POST SCRIPTUM
----------------------------------------------------------------------------

Dieses  Projekt  wurde  von  einem  Studenten  der  Informationswissenschaft
entwickelt.   Informationswissenschaft  ist nicht so bekannt wie Informatik,
doch   die  Qualifikationen  sind  weitreichend  und  gehen  weit  über  die
Beherrschung  der  Maschine  hinaus.   Informationswissenschaftler  erhalten
Qualifikationen,    die    vor    allem    in    der    sich   abzeichnenden
"Informationsgesellschaft"   immer   mehr   an   Bedeutung  gewinnen.   Alle
Informationsprozeße  -  beispielsweise  im  Informationsmanagement  - werden
analytisch durchleuchtet und Lösungen zu Problemen praktisch realisiert.

Dieses Post-Skriptum sollte ein wenig Licht ins Dunkel bringen, da viele mit
diesem Begriff der "Informationswissenschaft" nichts anfangen können.

Das  WWW-Angebot der Informationswissenschaft der Heinrich-Heine-Universität
Düsseldorf findest Du unter:

http://www.phil-fak.uni-duesseldorf.de/infowiss/

 PERMSSN    UID  GID    PACKED    SIZE  RATIO     CRC       STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                 1897    4666  40.7% -lh5- b081 Feb 13  1998 Raw2Ent/Docs/html/autor.html
[generic]                 2311   12054  19.2% -lh5- 9f6b Mar 18  1998 Raw2Ent/Docs/html/beispiele.html
[generic]                  850    2072  41.0% -lh5- ec8a Mar 18  1998 Raw2Ent/Docs/html/bye.html
[generic]                 2842    6572  43.2% -lh5- 7dda Mar 18  1998 Raw2Ent/Docs/html/einfuehrung.html
[generic]                 1462    3671  39.8% -lh5- 02e0 Mar 18  1998 Raw2Ent/Docs/html/fehler.html
[generic]                 6115   23415  26.1% -lh5- 7055 Mar 19  1998 Raw2Ent/Docs/html/gebrauch.html
[generic]                 1763    4774  36.9% -lh5- 7cf3 Mar 18  1998 Raw2Ent/Docs/html/geschichte.html
[generic]                 1637    3930  41.7% -lh5- 7751 Mar 19  1998 Raw2Ent/Docs/html/index.html
[generic]                  739    1599  46.2% -lh5- afae Mar 18  1998 Raw2Ent/Docs/html/installation.html
[generic]                  816    1543  52.9% -lh5- f2cf Mar 18  1998 Raw2Ent/Docs/html/limits.html
[generic]                25693   25693 100.0% -lh0- b3df Feb  8  1998 Raw2Ent/Docs/html/logic.gif
[generic]                10437   10437 100.0% -lh0- 6b91 Feb  7  1998 Raw2Ent/Docs/html/meta.gif
[generic]                 3251    3251 100.0% -lh0- aa7c Mar 18  1998 Raw2Ent/Docs/html/r2e-web.gif
[generic]                 2083    6793  30.7% -lh5- c578 Feb  9  1998 Raw2Ent/Docs/html/strukturen.html
[generic]                 1324    3676  36.0% -lh5- c983 Mar 18  1998 Raw2Ent/Docs/html/support.html
[generic]                 4355    4355 100.0% -lh0- b1d9 Feb  9  1998 Raw2Ent/Docs/html/tph.jpg
[generic]                 1282    3064  41.8% -lh5- 9a02 Mar 18  1998 Raw2Ent/Docs/html/voraussetzung.html
[generic]                 1682    3451  48.7% -lh5- ffaa Mar 18  1998 Raw2Ent/Docs/html/vorwort.html
[generic]                 8892   24771  35.9% -lh5- c22f Mar 14  1998 Raw2Ent/Docs/Raw2Ent.doc
[generic]                 9830   26906  36.5% -lh5- a258 Mar 21  1998 Raw2Ent/Docs/Raw2Ent.dok
[generic]                 3222    7591  42.4% -lh5- a29f Mar 21  1998 Raw2Ent/Docs/Raw2Ent.readme
[generic]                 2587   14604  17.7% -lh5- 79c3 Dec 27  1996 Raw2Ent/Docs/Raw2EntHTMLColors.iff
[generic]                  335    1489  22.5% -lh5- 4d31 Jan 18  1998 Raw2Ent/Docs/Raw2EntLogic.asc
[generic]                  255    1227  20.8% -lh5- 4208 Dec 13  1996 Raw2Ent/Docs/Raw2EntMeta.asc
[generic]                 5605   11092  50.5% -lh5- f54b Mar 21  1998 Raw2Ent/Raw2Ent
[generic]                  637    1192  53.4% -lh5- 4cff Dec 26  1996 Raw2Ent/Scripts/Raw2Ent.ced
[generic]                  580    1131  51.3% -lh5- 0677 Nov 17  1996 Raw2Ent/Scripts/Raw2Ent.rexx
[generic]                 1482    5120  28.9% -lh5- e293 Nov 17  1996 Raw2Ent/Scripts/Raw2Ent.rexx.old
[generic]                  287     465  61.7% -lh5- f4d1 Dec 12  1996 Raw2Ent/Scripts/Raw2EntCheck
[generic]                  288     386  74.6% -lh5- 18ee Jan 27  1998 Raw2Ent/Tables/MAC.r2e
[generic]                  296     386  76.7% -lh5- 7078 Jan 27  1998 Raw2Ent/Tables/MSDOS.r2e
[generic]                  265     386  68.7% -lh5- a718 Jan 27  1998 Raw2Ent/Tables/Template.r2e
[generic]                  388     487  79.7% -lh5- cb28 Jan 18  1998 Raw2Ent/Tables/Umlaute.r2e
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        33 files  105488  222249  47.5%            Mar 25  1998