./Source/makefile.mingw-cygwin

makefile.mingw-cygwin

[ Top ] [ ROBODoc ] [ Modules ]

NAME

makefile.mingw-cygwin -- Plain makefile that does not need autoconf

PURPOSE

The makefile for MingW Minimalist GNU for Windows under the Cygwin environment, See:

You can use it if you are on a win32 system.

The following targets are the most useful for the user:

robodoc - makes the robodoc executable.

Developers might try:

test - run system tests
clean - clean all results.

EXAMPLES make -f makefile.mingw-cygwin robodoc make -f makefile.mingw-cygwin test make -f makefile.mingw-cygwin clean

CFLAGS

[ Top ] [ makefile.mingw-cygwin ] [ Variables ]

FUNCTION

Defined the flags used for the C compiler:

-W, -Wall and -std=gnu99 -- This turns on all warnings based on the C99 standard. Making the source warning free for an earlier standard is not necessary as this code is compiled on Unix, Windows, and Mac systems that all have C99 compliant C compilers. It also allows some gnu extensions. Using -std=c99 gives some spurious warnings about popen()
-O3 -- optimize, turning optimization on finds more errors and warnings.
-mno-cygwin -- Tells gcc not to link with cygwin1.dll but use the windows standard C library. (make mingw windows native executable under cygwin)
-s -- Strip debug info out from objects, making the executable smaller
-g -- Include all debugger info for GDB

SOURCE

# Use CYGWIN = 1 to compile under native cygwin mode
ifdef CYGWIN
CYGFLAGS = -DHAVE_FORK -DHAVE_SYMLINK
else
CYGFLAGS = -mno-cygwin
endif

# Use DEBUG = 1 to include debugging symbols and to turn off optimisations
ifdef DEBUG
DFLAGS = -g
else
DFLAGS = -s -O3
endif

# Effective compiler flags
CFLAGS = -W -Wall -std=gnu99 -DHAVE_SNPRINTF $(DFLAGS) $(CYGFLAGS)

clean

[ Top ] [ makefile.mingw-cygwin ] [ Makefile entries ]

NAME

clean -- Clean up the mess we made.

FUNCTION

Cleans up the mess we made.

robodoc

[ Top ] [ makefile.mingw-cygwin ] [ Makefile entries ]

NAME

robodoc --

NOTE

This assumes that your version of make knows how to make an .o file out of an .c file.

SOURCE

$(ROBODOC) : $(OBJECTS) 
        $(CC) $(CFLAGS) $(OBJECTS) -o $(ROBODOC) $(LIBS)

robohdrs

[ Top ] [ makefile.mingw-cygwin ] [ Makefile entries ]

NAME

robohdrs --

SOURCE

ifdef CYGWIN
ROBOHRDS_SOURCES = robohdrs.o headers.o util.o globals.o roboconfig.o \
                   headertypes.o
else
ROBOHRDS_SOURCES = robohdrs.o
endif

$(ROBOHDRS) : $(ROBOHRDS_SOURCES)
        $(CC) $(CFLAGS) $(ROBOHRDS_SOURCES) -o $(ROBOHDRS)

SOURCES, HEADERS

[ Top ] [ makefile.mingw-cygwin ] [ Variables ]

FUNCTION

All source files needed to compile ROBODoc

SOURCE

SOURCES = \
          analyser.c \
          ascii_generator.c \
          directory.c \
          document.c \
          file.c \
          generator.c \
          globals.c \
          headers.c \
          headertypes.c \
          html_generator.c \
          items.c \
          latex_generator.c \
          links.c \
          optioncheck.c \
          part.c \
          path.c \
          roboconfig.c \
          robodoc.c \
          rtf_generator.c \
          test_generator.c \
          troff_generator.c \
          util.c \
          xmldocbook_generator.c

HEADERS= analyser.h \
         ascii_generator.h \
         directory.h \
         dirwalk.h \
         document.h \
         file.h \
         generator.h \
         globals.h \
         headertypes.h \
         headers.h \
         html_generator.h \
         items.h \
         latex_generator.h \
         links.h \
         optioncheck.h \
         part.h \
         path.h \
         roboconfig.h \
         robodoc.h \
         rtf_generator.h \
         troff_generator.h \
         unittest.h \
         util.h \
         test_generator.h \
         xmldocbook_generator.h

test

[ Top ] [ makefile.mingw-cygwin ] [ Makefile entries ]

NAME

test -- run some tests

FUNCTION

Runs robodoc on file with a number of different headers.