man/man1/qcc.1

.TH QCC

.SH NAME
qcc \- Quantum Circuits Compiler
      version 1.0

.SH SYNOPSIS
qcc [ \-c |\-\-help|\-h|\-v|\-V ] 
    [ \-C file.cpp ]
    [ \-o file.cpp/file.exe ]
    source.mcd
.PP
All options are listed here.
Notice that the options \-c and \-C cannot be used at the same time.
If done, \fIqcc\fP may not work as you intended.

.SH DESCRIPTION

.PP
\fIqcc\fP is an application that compile an mcd code into an
executable or a c++ code.
.PP
When you invoke \fIqcc\fP, it normally does compilation and linking.
The some options allow you to stop this process at an intermediate stage.
For example, the \-c option says not to run the linker. Then the output
consists of object files output by the mcd compiler; \fIqcpp\fP.

.SH OPTIONS
Option Details
.TP
\-c
Compile the source files into c++ code, and stop in that stage.
The next compiling and linking stage simply is not done.
The ultimate output is in the form of a c++ code for each source file.
.IP
By default, the output file name for a source file is made by replacing the
suffix .mcd with .cpp

.TP
\-\-help
Print (on the standard output) a description of the command line options
understood by qcc. 

.TP
\-h
Identical with \-\-help.

.TP
\-v
Print (on the standard error output) the commands executed to run the stage of
compilation.

.TP
\-V
Print (on the standard output) the version of this software.

.TP
\-C \fIfile\fP
Place output c++ code in file \fIfile\fP.
This option is useful when you want to obtain both the executable and the
c++ code simultaneously.
It is effective only when \-c option is \fBNOT\fP specified.
.IP
If \-c option, \-C option and \-o option are specified at the same time,
the \-C option will be ignored.

.TP
\-o \fIfile\fP
Place output in file \fIfile\fP.
This applies regardless to whatever sort of output is being produced, whether
it be an executable file or a c++ code.
Therefore, this option conflicts with \-C option.
.IP
If \-o is not specified, the default is put an executable file in \fIa.out\fP,
the c++ code for \fIsource\fP.mcd in \fIsource\fP.cpp.

.SH BUGS
For reporting bugs, please mail to
    <\fBjun@bopper.t.u-tokyo.ac.jp\fP>
, or
    <\fBkaityo@acolyte.t.u-tokyo.ac.jp\fP>

.SH SEE ALSO
\fIqcpp\fP(1), \fIqcrun\fP(1), \fIQCAD\fP(?)

.SH AUTHOR
This document is written by J. Yamazaki.

.SH COPYRIGHT
Copyright (c) 2002, 2003 QCAD project at the University of Tokyo,
Department of Applied Physics.
.PP
Permission is granted to distribute this document only if you've not changed
the contents of the package.
I hope this software will be distributed and/or modified under the term of
GNU Free Documentation License in the future, but not yet.
Please keep it in mind.
For more details, please see QCAD web site.
.PP
<http://acolyte.t.u-tokyo.ac.jp/~kaityo/qcad/>