Checklist for arXiv submission
By Ian
I am currently finishing up a paper that is about to be submitted to the arXiv and I thought I would go through the list of things I normally do just before sending the work off. It’s mainly a common sense list but in the rush to get something out it is good to have a list to work from to make sure you don’t miss anything (misspelling collaborators names is not helpful!).
- Check bib style is correct. If the journal you are planning to submit to has a particular house style for the bibliography it is probably worth using it in the arXiv submission.
- Check bibliography text is correct. Even though I think BiBTeX is the great, and much easier than preparing the bibliography by hand (which some people still do), there can be instances when a stray space or mistakenly capitalised letter appear. If you get your BiBTeX entries from SPIRES or Inspire this is mostly taken care of, but there is always the odd paper or book entry that you have typed in by hand. Check the final output in the paper, not just the .bib file contents.
- Check journal info for newer papers. Nowadays many works are first cited as preprints before publication in a journal and it is only right to update your reference list to include any subsequent publication information. Take care that the published version is not substantially different from the preprint as even the conclusions might have changed during the refereeing process.
- Check punctuation at end of equations.
It is considered best practice to include equations as part of a sentence and not standalone objects. Therefore you should treat them grammatically as just another word or phrase. If you continue the sentence after the equation include a comma at the end of the last equation line using
\,,
which introduces a small space before the comma. - Move bibliography from bbl to tex file.
The arXiv help page states that BiBTeX is not run when you submit a file. The way to include your bibliography is to either include your .bbl file in the bundle you submit or to manually copy in the contents of the .bbl file and replace the
\bibliography
and\bibliographystyle
commands in your .tex file. - Read through all equations. It might not be possible to rederive all the equations but a quick look through could catch any glaring errors in transcribing long equations into TeX.
- Remove revision control info from files.
If you use revision control to keep track of the changes to your paper (and you should!) then be careful to remove any files or tag lines with this info. For CVS you may have included a
$Id$
line with the revision number and date. If you are submitting a zipped directory of files be careful to exclude any control directories such as .git or .bzr. Perhaps in the age of open science every revision of your paper should be open to all, but it is likely you don't want the whole writing process to be scrutinized. - Remove extraneous commands. Any unused or temporary commands, which might for example add labels, todo lists, highlight changes, should be removed.
- Remove unnecessary comments. Again any unnecessary comments in the .tex file should be removed. Don't forget that anyone will be able to read the .tex file as well as the .dvi or .pdf files. Probably not the best idea to slag off your competitors in the comments then.
- Remove unused sections. In a similar vein don't leave unused sections commented out in the .tex file.
- Spellcheck document, abstract, authors. Although it is not straightforward to spellcheck LaTeX files you need to make sure that any easy typos have been caught. Take special care with the authors' names, as this might be one of the most embarrassing mistakes to make.