diff --git a/lib/Target/SparcV9/EmitBytecodeToAssembly.cpp b/lib/Target/SparcV9/EmitBytecodeToAssembly.cpp index 0e14580386c..0826f76284e 100644 --- a/lib/Target/SparcV9/EmitBytecodeToAssembly.cpp +++ b/lib/Target/SparcV9/EmitBytecodeToAssembly.cpp @@ -1,4 +1,4 @@ -//===-- EmitBytecodeToAssembly.cpp - Emit bytecode to SparcV9 .s File --------==// +//===-- EmitBytecodeToAssembly.cpp - Emit bytecode to SparcV9 .s File ------==// // // The LLVM Compiler Infrastructure // diff --git a/lib/Target/SparcV9/MachineInstrAnnot.h b/lib/Target/SparcV9/MachineInstrAnnot.h index 6b6d928d04f..13e68c042cf 100644 --- a/lib/Target/SparcV9/MachineInstrAnnot.h +++ b/lib/Target/SparcV9/MachineInstrAnnot.h @@ -1,4 +1,4 @@ -//===-- llvm/CodeGen/MachineInstrAnnot.h ------------------------*- C++ -*-===// +//===-- MachineInstrAnnot.h -------------------------------------*- C++ -*-===// // // The LLVM Compiler Infrastructure // @@ -7,12 +7,12 @@ // //===----------------------------------------------------------------------===// // -// Annotations used to pass information between code generation phases. +// Annotations used to pass information between SparcV9 code generation phases. // //===----------------------------------------------------------------------===// -#ifndef MACHINE_INSTR_ANNOT_h -#define MACHINE_INSTR_ANNOT_h +#ifndef MACHINEINSTRANNOT_H +#define MACHINEINSTRANNOT_H #include "llvm/CodeGen/MachineInstr.h" #include "SparcV9RegInfo.h" diff --git a/lib/Target/SparcV9/Makefile b/lib/Target/SparcV9/Makefile index 3c028f1632a..195a1bce52d 100644 --- a/lib/Target/SparcV9/Makefile +++ b/lib/Target/SparcV9/Makefile @@ -1,4 +1,4 @@ -##===- lib/Target/SparcV9/Makefile ---------------------------*- Makefile -*-===## +##===- lib/Target/SparcV9/Makefile -------------------------*- Makefile -*-===## # # The LLVM Compiler Infrastructure # diff --git a/lib/Target/SparcV9/MappingInfo.cpp b/lib/Target/SparcV9/MappingInfo.cpp index 4648c54e48e..3aa23592888 100644 --- a/lib/Target/SparcV9/MappingInfo.cpp +++ b/lib/Target/SparcV9/MappingInfo.cpp @@ -1,4 +1,4 @@ -//===- MappingInfo.cpp - create LLVM info and output to .s file ---------===// +//===- MappingInfo.cpp - create LLVM info and output to .s file -----------===// // // The LLVM Compiler Infrastructure // diff --git a/lib/Target/SparcV9/MappingInfo.h b/lib/Target/SparcV9/MappingInfo.h index 351d5f87a95..bf725a0a0fe 100644 --- a/lib/Target/SparcV9/MappingInfo.h +++ b/lib/Target/SparcV9/MappingInfo.h @@ -1,4 +1,4 @@ -//===- lib/Target/SparcV9/MappingInfo.h ---------------------------*- C++ -*-===// +//===- lib/Target/SparcV9/MappingInfo.h -------------------------*- C++ -*-===// // // The LLVM Compiler Infrastructure // diff --git a/lib/Target/SparcV9/SparcV9.td b/lib/Target/SparcV9/SparcV9.td index f20b57d909f..f31c364e6fb 100644 --- a/lib/Target/SparcV9/SparcV9.td +++ b/lib/Target/SparcV9/SparcV9.td @@ -1,4 +1,4 @@ -//===- SparcV9.td - Target Description for SparcV9 V9 Target ----------------===// +//===- SparcV9.td - Target Description for SparcV9 Target -----------------===// // // The LLVM Compiler Infrastructure // @@ -7,7 +7,8 @@ // //===----------------------------------------------------------------------===// // -// TODO: Need a description here. +// TableGen target description file for the SparcV9. This is currently used +// primarily to generate part of the SparcV9CodeEmitter automatically. // //===----------------------------------------------------------------------===// diff --git a/lib/Target/SparcV9/SparcV9AsmPrinter.cpp b/lib/Target/SparcV9/SparcV9AsmPrinter.cpp index 0fa4c49ceb4..0f8c2cdc374 100644 --- a/lib/Target/SparcV9/SparcV9AsmPrinter.cpp +++ b/lib/Target/SparcV9/SparcV9AsmPrinter.cpp @@ -1,4 +1,4 @@ -//===-- EmitAssembly.cpp - Emit SparcV9 Specific .s File ---------------------==// +//===-- EmitAssembly.cpp - Emit SparcV9 Specific .s File -------------------==// // // The LLVM Compiler Infrastructure // diff --git a/lib/Target/SparcV9/SparcV9FrameInfo.cpp b/lib/Target/SparcV9/SparcV9FrameInfo.cpp index a3f60496b65..91b94883f69 100644 --- a/lib/Target/SparcV9/SparcV9FrameInfo.cpp +++ b/lib/Target/SparcV9/SparcV9FrameInfo.cpp @@ -1,4 +1,4 @@ -//===-- SparcV9.cpp - General implementation file for the SparcV9 Target ------===// +//===-- SparcV9FrameInfo.cpp - Stack frame layout info for SparcV9 --------===// // // The LLVM Compiler Infrastructure // diff --git a/lib/Target/SparcV9/SparcV9FrameInfo.h b/lib/Target/SparcV9/SparcV9FrameInfo.h index d5f542cc18c..97153f8f970 100644 --- a/lib/Target/SparcV9/SparcV9FrameInfo.h +++ b/lib/Target/SparcV9/SparcV9FrameInfo.h @@ -1,4 +1,4 @@ -//===-- SparcV9FrameInfo.h - Define TargetFrameInfo for SparcV9 -----*- C++ -*-===// +//===-- SparcV9FrameInfo.h - Define TargetFrameInfo for SparcV9 -*- C++ -*-===// // // The LLVM Compiler Infrastructure // diff --git a/lib/Target/SparcV9/SparcV9Instr.def b/lib/Target/SparcV9/SparcV9Instr.def index f3ed337d6e9..f67ed939e2c 100644 --- a/lib/Target/SparcV9/SparcV9Instr.def +++ b/lib/Target/SparcV9/SparcV9Instr.def @@ -1,4 +1,4 @@ -//===-- SparcInstr.def - Sparc Instruction Information -----------*- C++ -*-==// +//===-- SparcV9Instr.def - SparcV9 Instruction Information -------*- C++ -*-==// // // The LLVM Compiler Infrastructure // diff --git a/lib/Target/SparcV9/SparcV9InstrInfo.cpp b/lib/Target/SparcV9/SparcV9InstrInfo.cpp index 7c123f7332a..b6d580622fe 100644 --- a/lib/Target/SparcV9/SparcV9InstrInfo.cpp +++ b/lib/Target/SparcV9/SparcV9InstrInfo.cpp @@ -1,4 +1,4 @@ -//===-- SparcV9InstrInfo.cpp ------------------------------------------------===// +//===-- SparcV9InstrInfo.cpp - SparcV9 Instr. Selection Support Methods ---===// // // The LLVM Compiler Infrastructure // @@ -7,6 +7,10 @@ // //===----------------------------------------------------------------------===// // +// This file contains various methods of the class SparcV9InstrInfo, many of +// which appear to build canned sequences of MachineInstrs, and are +// used in instruction selection. +// //===----------------------------------------------------------------------===// #include "llvm/Constants.h" diff --git a/lib/Target/SparcV9/SparcV9InstrInfo.h b/lib/Target/SparcV9/SparcV9InstrInfo.h index dcc2e151814..9a4aa167e92 100644 --- a/lib/Target/SparcV9/SparcV9InstrInfo.h +++ b/lib/Target/SparcV9/SparcV9InstrInfo.h @@ -8,7 +8,8 @@ //===----------------------------------------------------------------------===// // // This class contains information about individual instructions. -// Most information is stored in the SparcV9MachineInstrDesc array above. +// Also see the SparcV9MachineInstrDesc array, which can be found in +// SparcV9TargetMachine.cpp. // Other information is computed on demand, and most such functions // default to member functions in base class TargetInstrInfo. // diff --git a/lib/Target/SparcV9/SparcV9InstrSelection.cpp b/lib/Target/SparcV9/SparcV9InstrSelection.cpp index 0460f3803dd..122a97ea794 100644 --- a/lib/Target/SparcV9/SparcV9InstrSelection.cpp +++ b/lib/Target/SparcV9/SparcV9InstrSelection.cpp @@ -1,4 +1,4 @@ -//===-- SparcV9InstrSelection.cpp -------------------------------------------===// +//===-- SparcV9InstrSelection.cpp -----------------------------------------===// // // The LLVM Compiler Infrastructure // diff --git a/lib/Target/SparcV9/SparcV9InstrSelectionSupport.h b/lib/Target/SparcV9/SparcV9InstrSelectionSupport.h index 1fca89f9452..a59045fe05d 100644 --- a/lib/Target/SparcV9/SparcV9InstrSelectionSupport.h +++ b/lib/Target/SparcV9/SparcV9InstrSelectionSupport.h @@ -1,4 +1,4 @@ -//===-- llvm/CodeGen/SparcV9InstrSelectionSupport.h ---------------*- C++ -*-===// +//===-- SparcV9InstrSelectionSupport.h --------------------------*- C++ -*-===// // // The LLVM Compiler Infrastructure // @@ -7,12 +7,12 @@ // //===----------------------------------------------------------------------===// // -// TODO: Need a description here. +// More instruction selection support routines for the SparcV9 target. // //===----------------------------------------------------------------------===// -#ifndef SPARC_INSTR_SELECTION_SUPPORT_h -#define SPARC_INSTR_SELECTION_SUPPORT_h +#ifndef SPARCV9INSTRSELECTIONSUPPORT_H +#define SPARCV9INSTRSELECTIONSUPPORT_H #include "llvm/DerivedTypes.h" #include "SparcV9Internals.h" diff --git a/lib/Target/SparcV9/SparcV9Internals.h b/lib/Target/SparcV9/SparcV9Internals.h index 8afad9805af..edaa3d12d57 100644 --- a/lib/Target/SparcV9/SparcV9Internals.h +++ b/lib/Target/SparcV9/SparcV9Internals.h @@ -1,4 +1,4 @@ -//===-- SparcV9Internals.h ----------------------------------------*- C++ -*-===// +//===-- SparcV9Internals.h --------------------------------------*- C++ -*-===// // // The LLVM Compiler Infrastructure // @@ -12,8 +12,8 @@ // //===----------------------------------------------------------------------===// -#ifndef SPARC_INTERNALS_H -#define SPARC_INTERNALS_H +#ifndef SPARCV9INTERNALS_H +#define SPARCV9INTERNALS_H #include "llvm/CodeGen/MachineInstrBuilder.h" #include "llvm/Target/TargetMachine.h" diff --git a/lib/Target/SparcV9/SparcV9JITInfo.h b/lib/Target/SparcV9/SparcV9JITInfo.h index 244b13c22be..f7888aaf778 100644 --- a/lib/Target/SparcV9/SparcV9JITInfo.h +++ b/lib/Target/SparcV9/SparcV9JITInfo.h @@ -1,4 +1,4 @@ -//===- SparcV9JITInfo.h - SparcV9 implementation of the JIT interface -*-C++-*-===// +//===- SparcV9JITInfo.h - SparcV9 Target JIT interface ----------*- C++ -*-===// // // The LLVM Compiler Infrastructure // @@ -7,12 +7,14 @@ // //===----------------------------------------------------------------------===// // -// This file contains the SparcV9 implementation of the TargetJITInfo class. +// This file contains the SparcV9 implementation of the TargetJITInfo class, +// which makes target-specific hooks available to the target-independent +// LLVM JIT compiler. // //===----------------------------------------------------------------------===// -#ifndef SPARCJITINFO_H -#define SPARCJITINFO_H +#ifndef SPARCV9JITINFO_H +#define SPARCV9JITINFO_H #include "llvm/Target/TargetJITInfo.h" diff --git a/lib/Target/SparcV9/SparcV9PeepholeOpts.cpp b/lib/Target/SparcV9/SparcV9PeepholeOpts.cpp index 8bdf3ec42d4..61ba0fab5ec 100644 --- a/lib/Target/SparcV9/SparcV9PeepholeOpts.cpp +++ b/lib/Target/SparcV9/SparcV9PeepholeOpts.cpp @@ -1,4 +1,4 @@ -//===-- PeepholeOpts.cpp --------------------------------------------------===// +//===-- SparcV9PeepholeOpts.cpp -------------------------------------------===// // // The LLVM Compiler Infrastructure // diff --git a/lib/Target/SparcV9/SparcV9PreSelection.cpp b/lib/Target/SparcV9/SparcV9PreSelection.cpp index 2c265a9238d..40f753b4a95 100644 --- a/lib/Target/SparcV9/SparcV9PreSelection.cpp +++ b/lib/Target/SparcV9/SparcV9PreSelection.cpp @@ -1,4 +1,4 @@ -//===- PreSelection.cpp - Specialize LLVM code for target machine ---------===// +//===- SparcV9PreSelection.cpp - Specialize LLVM code for SparcV9 ---------===// // // The LLVM Compiler Infrastructure // @@ -7,10 +7,10 @@ // //===----------------------------------------------------------------------===// // -// This file defines the PreSelection pass which specializes LLVM code for a -// target machine, while remaining in legal portable LLVM form and -// preserving type information and type safety. This is meant to enable -// dataflow optimizations on target-specific operations such as accesses to +// This file defines the PreSelection pass which specializes LLVM code for +// the SparcV9 instruction selector, while remaining in legal portable LLVM +// form and preserving type information and type safety. This is meant to enable +// dataflow optimizations on SparcV9-specific operations such as accesses to // constants, globals, and array indexing. // //===----------------------------------------------------------------------===// @@ -34,7 +34,7 @@ using namespace llvm; namespace { //===--------------------------------------------------------------------===// - // PreSelection Pass - Specialize LLVM code for the current target machine. + // PreSelection Pass - Specialize LLVM code for the SparcV9 instr. selector. // class PreSelection : public FunctionPass, public InstVisitor { const TargetInstrInfo &instrInfo; diff --git a/lib/Target/SparcV9/SparcV9PrologEpilogInserter.cpp b/lib/Target/SparcV9/SparcV9PrologEpilogInserter.cpp index 48874e7369b..9749ede2758 100644 --- a/lib/Target/SparcV9/SparcV9PrologEpilogInserter.cpp +++ b/lib/Target/SparcV9/SparcV9PrologEpilogInserter.cpp @@ -1,4 +1,4 @@ -//===-- PrologEpilogCodeInserter.cpp - Insert Prolog & Epilog code for fn -===// +//===-- SparcV9PrologEpilogCodeInserter.cpp - Insert Fn Prolog & Epilog ---===// // // The LLVM Compiler Infrastructure // diff --git a/lib/Target/SparcV9/SparcV9RegClassInfo.cpp b/lib/Target/SparcV9/SparcV9RegClassInfo.cpp index d0fe1174d10..0f83bb20375 100644 --- a/lib/Target/SparcV9/SparcV9RegClassInfo.cpp +++ b/lib/Target/SparcV9/SparcV9RegClassInfo.cpp @@ -1,4 +1,4 @@ -//===-- SparcV9RegClassInfo.cpp - Register class def'ns for SparcV9 -----------===// +//===-- SparcV9RegClassInfo.cpp - Register class def'ns for SparcV9 -------===// // // The LLVM Compiler Infrastructure // @@ -7,7 +7,9 @@ // //===----------------------------------------------------------------------===// // -// This file defines the register classes used by the SparcV9 target description. +// This file defines the methods used by the SparcV9 register allocator +// to pick registers of various classes. Most of this code should be +// considered part of the register allocator. // //===----------------------------------------------------------------------===// diff --git a/lib/Target/SparcV9/SparcV9RegClassInfo.h b/lib/Target/SparcV9/SparcV9RegClassInfo.h index 1c7b3de8289..e01c69f4570 100644 --- a/lib/Target/SparcV9/SparcV9RegClassInfo.h +++ b/lib/Target/SparcV9/SparcV9RegClassInfo.h @@ -1,4 +1,4 @@ -//===-- SparcV9RegClassInfo.h - Register class def'ns for SparcV9 ---*- C++ -*-===// +//===-- SparcV9RegClassInfo.h - Register class def'ns for SparcV9 -*- C++ -*-=// // // The LLVM Compiler Infrastructure // @@ -7,7 +7,10 @@ // //===----------------------------------------------------------------------===// // -// This file defines the register classes used by the SparcV9 target description. +// This file defines the register classes used by the SparcV9 target. It +// implicitly defines (using enums) the "class register numbers" used in +// the SparcV9 target, which are converted using a formula in the TargetRegInfo +// class to "unified register numbers". // //===----------------------------------------------------------------------===// diff --git a/lib/Target/SparcV9/SparcV9RegInfo.cpp b/lib/Target/SparcV9/SparcV9RegInfo.cpp index 89aad0495f6..513437e7548 100644 --- a/lib/Target/SparcV9/SparcV9RegInfo.cpp +++ b/lib/Target/SparcV9/SparcV9RegInfo.cpp @@ -1,4 +1,4 @@ -//===-- SparcV9RegInfo.cpp - SparcV9 Target Register Information --------------===// +//===-- SparcV9RegInfo.cpp - SparcV9 Target Register Information ----------===// // // The LLVM Compiler Infrastructure // @@ -7,7 +7,7 @@ // //===----------------------------------------------------------------------===// // -// This file contains implementation of SparcV9 specific helper methods +// This file contains implementations of SparcV9 specific helper methods // used for register allocation. // //===----------------------------------------------------------------------===// diff --git a/lib/Target/SparcV9/SparcV9SchedInfo.cpp b/lib/Target/SparcV9/SparcV9SchedInfo.cpp index 7b7da721a60..39d616419f1 100644 --- a/lib/Target/SparcV9/SparcV9SchedInfo.cpp +++ b/lib/Target/SparcV9/SparcV9SchedInfo.cpp @@ -1,4 +1,4 @@ -//===-- UltraSparcV9SchedInfo.cpp -------------------------------------------===// +//===-- SparcV9SchedInfo.cpp ----------------------------------------------===// // // The LLVM Compiler Infrastructure // @@ -7,7 +7,7 @@ // //===----------------------------------------------------------------------===// // -// Describe the scheduling characteristics of the UltraSparcV9 +// Describe the scheduling characteristics of the UltraSparc IIi. // //===----------------------------------------------------------------------===// diff --git a/lib/Target/SparcV9/SparcV9StackSlots.cpp b/lib/Target/SparcV9/SparcV9StackSlots.cpp index e11effc4b13..c21defbd4df 100644 --- a/lib/Target/SparcV9/SparcV9StackSlots.cpp +++ b/lib/Target/SparcV9/SparcV9StackSlots.cpp @@ -1,4 +1,4 @@ -//===- StackSlots.cpp - Specialize LLVM code for target machine ----------===// +//===- SparcV9StackSlots.cpp - Add empty stack slots to functions ---------===// // // The LLVM Compiler Infrastructure // diff --git a/lib/Target/SparcV9/SparcV9TargetMachine.cpp b/lib/Target/SparcV9/SparcV9TargetMachine.cpp index f15f9412f83..c5d815c987e 100644 --- a/lib/Target/SparcV9/SparcV9TargetMachine.cpp +++ b/lib/Target/SparcV9/SparcV9TargetMachine.cpp @@ -1,4 +1,4 @@ -//===-- SparcV9.cpp - General implementation file for the SparcV9 Target ------===// +//===-- SparcV9TargetMachine.cpp - SparcV9 Target Machine Implementation --===// // // The LLVM Compiler Infrastructure // diff --git a/lib/Target/SparcV9/SparcV9TargetMachine.h b/lib/Target/SparcV9/SparcV9TargetMachine.h index 8f1d0883851..747c0501a98 100644 --- a/lib/Target/SparcV9/SparcV9TargetMachine.h +++ b/lib/Target/SparcV9/SparcV9TargetMachine.h @@ -1,4 +1,4 @@ -//===-- SparcV9TargetMachine.h - Define TargetMachine for SparcV9 ---*- C++ -*-===// +//===-- SparcV9TargetMachine.h - Define TargetMachine for SparcV9 -*- C++ -*-=// // // The LLVM Compiler Infrastructure // @@ -7,12 +7,12 @@ // //===----------------------------------------------------------------------===// // -// This file declares the top-level UltraSPARC target machine. +// This file declares the top-level SparcV9 target machine. // //===----------------------------------------------------------------------===// -#ifndef SPARC_TARGETMACHINE_H -#define SPARC_TARGETMACHINE_H +#ifndef SPARCV9TARGETMACHINE_H +#define SPARCV9TARGETMACHINE_H #include "llvm/Target/TargetFrameInfo.h" #include "llvm/Target/TargetMachine.h" diff --git a/lib/Target/SparcV9/SparcV9_F2.td b/lib/Target/SparcV9/SparcV9_F2.td index 56500ae8f0c..e9df4d2a062 100644 --- a/lib/Target/SparcV9/SparcV9_F2.td +++ b/lib/Target/SparcV9/SparcV9_F2.td @@ -1,4 +1,4 @@ -//===- SparcV9_F2.td - Format 2 instructions: SparcV9 V9 Target -------------===// +//===- SparcV9_F2.td - Format 2 instructions: SparcV9 Target --------------===// // // The LLVM Compiler Infrastructure // diff --git a/lib/Target/SparcV9/SparcV9_F3.td b/lib/Target/SparcV9/SparcV9_F3.td index ae03fbac9b7..4d03ff1b095 100644 --- a/lib/Target/SparcV9/SparcV9_F3.td +++ b/lib/Target/SparcV9/SparcV9_F3.td @@ -1,4 +1,4 @@ -//===- SparcV9_F3.td - Format 3 Instructions: SparcV9 V9 Target -------------===// +//===- SparcV9_F3.td - Format 3 Instructions: SparcV9 Target --------------===// // // The LLVM Compiler Infrastructure // diff --git a/lib/Target/SparcV9/SparcV9_F4.td b/lib/Target/SparcV9/SparcV9_F4.td index 64fc52a1c52..12941e950e0 100644 --- a/lib/Target/SparcV9/SparcV9_F4.td +++ b/lib/Target/SparcV9/SparcV9_F4.td @@ -1,4 +1,4 @@ -//===- SparcV9_F4.td - Format 4 instructions: SparcV9 V9 Target -------------===// +//===- SparcV9_F4.td - Format 4 instructions: SparcV9 Target --------------===// // // The LLVM Compiler Infrastructure // diff --git a/lib/Target/SparcV9/SparcV9_Reg.td b/lib/Target/SparcV9/SparcV9_Reg.td index 95ad48e1594..3f3e96da0ad 100644 --- a/lib/Target/SparcV9/SparcV9_Reg.td +++ b/lib/Target/SparcV9/SparcV9_Reg.td @@ -1,4 +1,4 @@ -//===- SparcV9_Reg.td - SparcV9 V9 Register definitions ---------------------===// +//===- SparcV9_Reg.td - SparcV9 Register definitions ----------------------===// // // The LLVM Compiler Infrastructure //