Skip to content

Commit

Permalink
Minor changes to README and Doxyfile
Browse files Browse the repository at this point in the history
* Updated README.md for consistency and improved descriptions;
* Changed Doxyfile to not generate verbatim copies of header files and 
to avoid stripping code comments from files;
  • Loading branch information
AndreLaranjeira committed Oct 19, 2021
1 parent 3abf867 commit 4b912b4
Show file tree
Hide file tree
Showing 2 changed files with 9 additions and 9 deletions.
4 changes: 2 additions & 2 deletions Doxyfile
Original file line number Diff line number Diff line change
Expand Up @@ -1053,7 +1053,7 @@ INLINE_SOURCES = NO
# Fortran comments will always remain visible.
# The default value is: YES.

STRIP_CODE_COMMENTS = YES
STRIP_CODE_COMMENTS = NO

# If the REFERENCED_BY_RELATION tag is set to YES then for each documented
# entity all documented functions referencing it will be listed.
Expand Down Expand Up @@ -1113,7 +1113,7 @@ USE_HTAGS = NO
# See also: Section \class.
# The default value is: YES.

VERBATIM_HEADERS = YES
VERBATIM_HEADERS = NO

#---------------------------------------------------------------------------
# Configuration options related to the alphabetical class index
Expand Down
14 changes: 7 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
# Message Logger

## Description
A simple message logger for the C programming language with different message types. Meant to be used in everyday projects to simplify the task of printing messages to the user.
A simple message logger for the C programming language with different message types. Meant to be used in everyday projects to simplify the task of printing messages to the user or saving them in a log file.

## Features
- Five different types of messages with context fields: message, success, warning, error and info.
- Public functions to color the text and the background, giving the programmer greater flexibility.
- Optional configuration to store logged messages in a separate file.
- Configurable time format for messages.
- Optional configuration to store logged messages in a separate log file.
- Configurable time format for log file.
- Thread-safe message logging.
- Color customization for message types.

Expand All @@ -17,7 +17,7 @@ A simple message logger for the C programming language with different message ty

* `doxygen` - For generating documentation;
* `gcc` - For compiling the sample file;
* `libpthread` - For compiling the message logger module;
* `libpthread` - For compiling the Message Logger module;
* `pdflatex` \(optional\) - For compiling the documentation in the latex format;

### Use it in your projects
Expand All @@ -32,17 +32,17 @@ Feel free to use, modify and examine the message logger's code in any way that i

### Generating documentation

To generate the documentation for the message logger module, you will need to have the program `doxygen` installed and included in your $PATH. You will also need the program `pdflatex` installed and included in your $PATH if you want to compile the documentation in the latex format.
To generate the documentation for the Message Logger module, you will need to have the program `doxygen` installed and included in your $PATH. You will also need the program `pdflatex` installed and included in your $PATH if you want to compile the documentation in the latex format.

Once you have installed the necessary dependencies, simply run the command `make doc`, on a shell from the **project's root directory**. This should generate documentation files both in the HTML and Latex formats. The makefile will then prompt you if you want to immediately open any of the generated documentation.

To open the generated HTML documentation, open the file `doc/html/index.html`. To open the generated latex documentation, compile the latex files with the generated makefile by running `make` in the directory `doc/latex` and open the file `doc/latex/refman.pdf`.

### Sample file

If you want to see this message logger module in action, we have included the `sample.c` source code file, which showcases some of the available features in this message logger module. To compile this sample into an executable, you will need the program `gcc` installed and included in your $PATH. If you wish to use a different compiler, change the `CC` variable in the `Makefile` and make any appropriate changes to how this variable is called.
If you want to see this Message Logger module in action, we have included the `sample.c` source code file, which showcases some of the available features in this Message Logger module. To compile this sample into an executable, you will need the program `gcc` installed and included in your $PATH. If you wish to use a different compiler, change the `CC` variable in the `Makefile` and make any appropriate changes to how this variable is called.

To sample the message logger module, follow the commands bellow:
To sample the Message Logger module, follow the commands bellow:

1. Run the command `make`, on a shell from the **project's root directory** to compile said source file into an executable;
2. Open the executable `msg-logger-sample` that was generated.
Expand Down

0 comments on commit 4b912b4

Please sign in to comment.