From 4360fbd36203022fde68b12f90548ca3a39085ce Mon Sep 17 00:00:00 2001 From: Mohammad Akhlaghi Date: Tue, 27 Feb 2018 10:42:20 +0100 Subject: Copyrights and TeX management made more clear Until now, the copyright statement was left empty for the users of the pipeline to fill. However, the files have already been created and have an author (or contributing authors) before the user starts using the pipeline. So the original authors of the files are added along with the year. The user can add their own name to the existing files under the "Contributing author" when they start and they will be the "Original author" of the new files they create. Several changes were also made to the TeX management: - LaTeX is run within a `reproduce/build/tex/build' directory now. Not in the top reproduction pipeline directory. This helps keep all the auxiliary TeX files and directories in that directory and keep the top reproduction pipeline directory clean. After the final PDF is built, a copy is put in the top reproduction pipeline directory for easy viewing. - The PGFPlots preamble was also made more useful, allowing the name of the `.tex' file to also be the name of the final plot that is produced. This is a GREAT feature, because without it, the TiKZ externalization would be based on order of the plots within the paper. But now, order is irrelevant and we can even delete the TiKZ files within the processing workhorse-Makefiles so the plots are definitly rebuilt on the next run. - The paper is now in a two-column format to be more similar to published papers. A tip on debugging Make was added to `README.md'. --- README.md | 17 +++++++++++++---- 1 file changed, 13 insertions(+), 4 deletions(-) (limited to 'README.md') diff --git a/README.md b/README.md index b2694ad..546b4b4 100644 --- a/README.md +++ b/README.md @@ -314,10 +314,10 @@ been explained here), please let us know to correct it. ``` - **Copyright**, **name** and **date**: Go over the following files and - correct the copyright, names and dates in their first few lines: - `configure`, `Makefile` and `reproduce/src/make/*.mk`. When making new - files, always remember to add a similar copyright statement at the top - of the tile. + add your name and email to the copyright notice: `configure`, + `Makefile` and `reproduce/src/make/*.mk`. When making new files, + always remember to add a similar copyright statement at the top of the + file. - **Title**, **short description** and **author** of project: In this raw skeleton, the title or short description of your project should be @@ -551,6 +551,15 @@ us. In this way, we can add it here for the benefit of others. $ info make "automatic variables ``` + - *Debug*: Since Make doesn't follow the common top-down paradigm, it + can be a little hard to get accustomed to why you get an error or + un-expected behavior. In such cases, run Make with the `-d` + option. With this option, Make prints a full list of exactly which + prerequisites are being checked for which targets. Looking + (patiently) through this output and searching for the faulty + file/step will clearly show you any mistake you might have made in + defining the targets or prerequisites. + - *Large files*: If you are dealing with very large files (thus having multiple copies of them for intermediate steps is not possible), one solution is the following strategy. Set a small plain text file as -- cgit v1.2.1