Package: avra
Version: 1.0.1-0.1
Severity: minor
Tags: patch

hi,

avra is missing a manual page. i have created one (attached), perhaps it
suits you.

cu  robert

-- System Information:
Debian Release: testing/unstable
  APT prefers unstable
  APT policy: (670, 'unstable'), (600, 'experimental')
Architecture: i386 (i686)
Shell:  /bin/sh linked to /bin/bash
Kernel: Linux 2.6.16.1
Locale: LANG=C, [EMAIL PROTECTED] (charmap=ISO-8859-15)

Versions of packages avra depends on:
ii  libc6                         2.3.6-4    GNU C Library: Shared libraries an

avra recommends no packages.

-- no debconf information

-- 
Robert Lemmen                               http://www.semistable.com 
.TH avra 1 "Jan 23, 2006" "Atmel AVR Assembler" "Atmel AVR Assembler"

.SH NAME
avra \- Assembler for the Atmel AVR microcontroller family

.SH SYNOPSIS
.B avra [\fB\-f\fR] [\fBO\fR|\fBM\fR|\fBI\fR|\fBG\fR\fR] output file type
        [\fB\-o\fR \fI<filename>\fR] output file name
        [\fB\-l\fR \fI<filename>\fR] generate list file
        [\fB\-m\fR \fI<mapfile>\fR] generate map file
        [\fB\-\-define\fR \fI<symbol>[=<value>]\fR] [\fB\-\-includedir\fR 
\fI<dir\fR] [\fB\-\listmac\fR]
        [\fB\-\-max_errors\fR \fI<number>\fR] [\fB\-\-devices\fR] 
[\fB\-\-version\fR]
        [\fB\-h\fR] [\fB\-\-help\fR] general help
        \fI<file to assemble>\fR

.SH DESCRIPTION
\fBAVRA\fR is an assembler for Atmel AVR microcontrollers, and it is almost
compatible with Atmel's own assembler AVRASM32.  The differences between the 
two are:

.IP "Support for some extra preprocessor directives." 
includes: .define, .undef, .ifdef, .ifndef, .if, .else, .endif, .elif, .warning

.IP "Not all command line options are supported."
Specifying an eeprom file (-e) is not supported. All eeprom data is
put out into a file called program.eep.hex and always Intel hex
format. Other hex file formats than Intel are currently not supported.

.IP "Forward references are not supported."
Like in C, you have to define everything before you are using it,
excepting labels. This makes sure, that directives like .ifdef and .undef 
are working properly. If you are familiar with the C programming
language, you should get easily into \fBAVRA\fR. See chapter "Programming
techniques" for more information about how to write proper code.

.IP "Enhanced macro support."
\fBAVRA\fR has some new features for writing flexible macros. This should
increase the ability to reuse code e.g. build your own library.

.IP "Debugging support."
\fBAVRA\fR creates a coff file everytime the assembly was sucessful. This
file allows AVR Studio or any coff compatible debugger to simulate
or emulate the program.

.IP "Meta tags for assembly time."
This helps you tracking versions of your software and can also be
used to generate customer specific serial numbers.

.SH OPTIONS
Several option can be given after one '-', but if an option requires an
argument; the argument must be given after that option.
.TP
.B \-\-listfile, \-l 
Create list file
.TP
.B \-\-mapfile, \-m 
Create map file
.TP
.B \-\-define, \-D 
Define symbol.
.TP
.B \-\-includedir, \-I 
Additional include dirs.
.TP
.B \-\-listmac        
List macro expansion in listfile.
.TP
.B \-\-max_errors     
Maximum number of errors before exit (default: 10)
.TP
.B \-\-devices        
List out supported devices.
.TP
.B \-\-version        
Version information.
.TP
.B \-\-help, -h       
Show summary of options.

.SH "SEE ALSO"
.BR avrp (1)

.SH AUTHOR
The initial version of AVRA was written by John Anders Haugum. He released
all versions until v0.7. All later versions were released by Tobias Weber.

Attachment: signature.asc
Description: Digital signature

Reply via email to