Copyright (c) Hyperion Entertainment and contributors.

Difference between revisions of "SDK Developer Tools"

From AmigaOS Documentation Wiki
Jump to navigation Jump to search
(Added examples)
Line 133: Line 133:
 
| CHARSET || A MIME character set name or alias.
 
| CHARSET || A MIME character set name or alias.
 
|}
 
|}
  +
  +
; Example 1
  +
Parse a text file "CP1258.TXT" and display a list of entries with the index on the left and the Unicode codepoint at the right side.
  +
1> BuildMapTable CP1258.TXT
  +
  +
Note: unmapped entries (with Unicode codepoint 0) are not displayed.
  +
  +
; Example 2
  +
Parse a text file "8859-1.TXT" and create a file "L:Charsets/ISO-8859-1" (latin1 is an alias for ISO-8859-1).
  +
1> BuildMapTable 8859-1.TXT CHARSET LATIN1
   
 
== ARexx Interface ==
 
== ARexx Interface ==

Revision as of 09:35, 14 June 2020

Contents

Introduction

The Software Development Kit (SDK) contains a suite of software tools to aid developers in making software for AmigaOS.

AutoDoc

AutoDoc extracts and sorts autodocs from the given files and prints them in the standard output.

Tool Types

(none)

Shell Usage

Format
AUTODOC [-t <number>] [-i] [-o] [-a] [-s] [-C] [-l <length>] [-w] [-c] [-f] [-r] [-F <file>] [-I] {<infile>}
Template
[-t number] [-i] [-o] [-a] [-s] [-C] [-l length] [-w] [-c] [-f] [-r] [-F file] [-I] {infile}
Location
SDK:C

The options are:

{<infile>} List of files to be processed.
-t<number> Turn tabulators to given number of spaces.
-i Process only INTERNAL autodocs.
-o Process only OBSOLETE autodocs.
-a Do not process autodocs starting with an asterisk.
-s Process autodocs starting with a semicolon.
-C Process autodocs starting with "/*". This is the default setting.
-l<number> Set the line length for the output. The default is 78.
-w Turn off word wrapping.
-c Do not convert "\*" to "/*" or "*\" to "*/".
-f Do not add form feeds between the autodoc entries.
-r Generate Troff source output.
-F<file> Use <file> as a temporary file. The default temporary file is "tmpfile".
-I Do not print "Table of Contents" before entries. If omitted, "Table of Contents" will be printed after the entries.
Example

Extract autodocs from files "main.c" and "functions.h" and redirect AutoDoc's output to file "MyDocs.doc".

1> autodoc -a -C main.c functions.h >MyDocs.doc

ARexx Interface

AutoDoc has no ARexx interface.

BuildLanguageCT

This tool generates a catalog translation file (CT file) from the current system language driver.

A new language.catalog can be created with a CatComp tool using the generated CT file and a language catalog description file (located in "SYS:Locale-Source/language.cd").

Tool Types

(none)

Shell Usage

Format
BUILDLANGUAGECT
Template
(none)
Location
SDK:C
Example 1

List the current language driver strings.

 1> BuildLanguageCT
Example 2

Create a "language.ct" file with the built-in strings of the current system language driver.

 1> BuildLanguageCT >language.ct

ARexx Interface

BuildLanguageCT has no ARexx interface.

BuildMapTable

BuildMapTable converts Charset-To-Unicode mapping tables in text form (e.g. available at http://www.unicode.org/Public/MAPPINGS/) to mapping tables in binary form usable by diskfont.library.

You must specify a character set mapping table file name when using the BuildMapTable command.

BuildMapTable can either display a text form of the parsed table or create a binary mapping table in the "L:Charsets/" directory. Currently only 8-bit character set mapping tables are supported.

If "L:Charsets/character-sets" or "L:Charsets/custom-character-sets" contains a MIME name for an 8-bit character set where no mapping table in "L:Charsets/" does not exist, and you have a mapping table in text form, use BuildMapTable to create the binary mapping table and reboot (diskfont.library searches tables only once) to be able to use the new character set (e.g. in fonts or catalog files).

The expected format of text mapping tables is as follows:

  • Anything from a '#' character to the end of a line is considered a comment.
  • A valid line does contain the index on the left and the Unicode point at the right side, in either hexadecimal (starting with 0x or 0X) or octal (starting with 0) or decimal form, separated by empty space.
Example

0xA4 0x20AC # EURO SIGN

Tool Types

(none)

Shell Usage

Format
BUILDMAPTABLE <ASCII mapping table> [CHARSET]
Template
UNICODEMAPTABLE/A,CHARSET/K
Location
SDK:C

The options are:

UNICODEMAPTABLE A character set mapping table file.
CHARSET A MIME character set name or alias.
Example 1

Parse a text file "CP1258.TXT" and display a list of entries with the index on the left and the Unicode codepoint at the right side.

 1> BuildMapTable CP1258.TXT

Note: unmapped entries (with Unicode codepoint 0) are not displayed.

Example 2

Parse a text file "8859-1.TXT" and create a file "L:Charsets/ISO-8859-1" (latin1 is an alias for ISO-8859-1).

 1> BuildMapTable 8859-1.TXT CHARSET LATIN1

ARexx Interface

BuildMapTable has no ARexx interface.

BumpRev

Missing description.

Tool Types

Shell Usage

Format
Template
Location
SDK:C

ARexx Interface

CatComp

Missing description.

Tool Types

Shell Usage

Format
Template
Location
SDK:C

ARexx Interface

ChangeRegs

Missing description.

Tool Types

Shell Usage

Format
Template
Location
SDK:C

ARexx Interface

DistCC

Missing description.

Tool Types

Shell Usage

Format
Template
Location
SDK:C

ARexx Interface

DistCCD

Missing description.

Tool Types

Shell Usage

ARexx Interface

DistCCMon-Amiga

Missing description.

Tool Types

Shell Usage

Format
Template
Location
SDK:C

ARexx Interface

DistCCMon-Text

Missing description.

Tool Types

Shell Usage

Format
Template
Location
SDK:C

ARexx Interface

Expunge

Missing description.

Tool Types

Shell Usage

Format
Template
Location
SDK:C

ARexx Interface

FDTrans

Missing description.

Tool Types

Shell Usage

Format
Template
Location
SDK:C

ARexx Interface

FSTest

Missing description.

Tool Types

Shell Usage

Format
Template
Location
SDK:C

ARexx Interface

FSVPTool

Missing description.

Tool Types

Shell Usage

Format
Template
Location
SDK:C

ARexx Interface

GDB

Missing description.

Tool Types

Shell Usage

Format
Template
Location
SDK:C

ARexx Interface

GMake

Missing description.

Tool Types

Shell Usage

Format
Template
Location
SDK:C

ARexx Interface

GUnZip

Missing description.

Tool Types

Shell Usage

Format
Template
Location
SDK:C

ARexx Interface

GZip

Missing description.

Tool Types

Shell Usage

Format
Template
Location
SDK:C

ARexx Interface

IDLTool

Missing description.

Tool Types

Shell Usage

Format
Template
Location
SDK:C

ARexx Interface

ListDynDep

Missing description.

Tool Types

Shell Usage

Format
Template
Location
SDK:C

ARexx Interface

Localize

Missing description.

Tool Types

Shell Usage

Format
Template
Location
SDK:C

ARexx Interface

Make

Missing description.

Tool Types

Shell Usage

Format
Template
Location
SDK:C

ARexx Interface

MakeAudioMode

Missing description.

Tool Types

Shell Usage

Format
Template
Location
SDK:C

ARexx Interface

ModList

Missing description.

Tool Types

Shell Usage

Format
Template
Location
SDK:C

ARexx Interface

SH

Missing description.

Tool Types

Shell Usage

Format
Template
Location
SDK:C

ARexx Interface

TAR

Missing description.

Tool Types

Shell Usage

Format
Template
Location
SDK:C

ARexx Interface

USBSnoop

Missing description.

Tool Types

Shell Usage

Format
Template
Location
SDK:C

ARexx Interface