42

I have started to use the FIXME, TODO, ??? and !!! tags in XCode but have am finding it painful that it does not recognise the tags when they are within a function. The tags are only recognised outside a given function.

How can I get these tags recognised within a function (as this is where the bugs are)?

8
  • 1
    Maybe it's because I'm still on Xcode 3.2.6, but those show up fine in the list of functions ... are you looking for some kind of indentation to show membership in the function?
    – Richard
    May 5, 2011 at 0:25
  • 1
    Could you please indicate what version of Xcode you're on and (if not Obj-C) what language you're writing in?
    – jscs
    May 5, 2011 at 1:22
  • I'd recommend filing a bug report with Apple requesting this feature if you haven't already: bugreport.apple.com
    – Stuart M
    May 5, 2011 at 8:44
  • 4
    This is a known issue and is under consideration in bug: Bug ID# 7604687
    – Ben
    May 10, 2011 at 18:31
  • 1
    This is still not fixed in 4.3, I don't think they care much Feb 25, 2012 at 7:02

9 Answers 9

51

In xcode 4.1 (don't know if this works in previous versions) I write

#warning TODO: fix this later...

to get a compile warning or

#error FIXME: fix now!

to get a compile error.

I also add these to the code snippet library to make it really ease to add todos.

3
37

A workaround is to use a build script which marks those as warnings:

KEYWORDS="TODO|FIXME|\?\?\?:|\!\!\!:"
find "${SRCROOT}" \( -name "*.h" -or -name "*.m" \) -print0 | \
xargs -0 egrep --with-filename --line-number --only-matching "($KEYWORDS).*\$" | \
perl -p -e "s/($KEYWORDS)/ warning: \$1/"

Credit to Benjamin Ragheb.

6
  • 11
    the script is found here by Benjamin Ragheb
    – KDaker
    Aug 27, 2011 at 14:58
  • 3
    this script fails if your code is stored in a file path which contains directories with spaces in them. For example "/Home/John/iPhone Apps/Code". Simple fix, on the second line, put quotes around ${SRCROOT}
    – john
    Oct 21, 2011 at 3:20
  • I put this in a run script in Xcode but somehow it's not picking up any of my TODOs. Any idea why Jan 16, 2012 at 7:24
  • Combine this with a project template: stackoverflow.com/questions/5550958/…
    – basvk
    Apr 26, 2013 at 6:38
  • 1
    second line should be changed in order to support .swift files: find "${SRCROOT}" \( -name "*.h" -or -name "*.m" -or -name "*.swift" \) -print0 | \
    – art-divin
    Jan 24, 2015 at 15:31
20

Edited 2016-02-02

Xcode now supports //MARK:, //TODO: and //FIXME: landmarks to annotate your code and lists them in the jump bar.


To find those special markups (and actually any markups you specify yourself), you can use the search navigator, enter the following string and then choose "In Project, matching regex "...", ignore case":

(//FIXME|//!!!|//\?\?\?|//TODO)

This will search your project for all those special markups. You can even add any markup you would like to, e.g. "//REVIEW: please review the following code". This would then be the following search string:

(//FIXME|//!!!|//\?\?\?|//TODO|//REVIEW)

I created a tab in my workspace which has the search navigator always open, filled with this string. Unfortunately, XCode will sometimes remove this string from the searchbox, so you have to have it copy&paste ready whenever you need it.

8

The FIXME:, TODO:, ???: and !!!: works in 4.3.3 inside and outside of functions.

You can have any number of whitespace before or after the double slash, but you have to use uppercase and follow the tag with a colon.

Just to make it clear - all of these work:

//          FIXME: This works.
  //TODO: This works.
    //                  !!!: Working.
// // //???: Works as well.
1
  • Gatada, can you elaborate on the bug you still find.
    – Ben
    Dec 20, 2012 at 21:28
4

how about this Xcode plugin? --> https://github.com/trawor/XToDo

2
  • It's ok, it crashed on me a few times in XCode 5.0.2. You have to create the plug-in folder manually in XCode 5 if you don't already have one. It's very basic, it creates a list of the 4 default markers: TODO, FIXME, ??? & !!! and puts anything marked with those, into a drop down list in a separate XCode window: however, I'd like to be able to create my own markers, like "BOOKMARK:" and "WATCH:" and have them show up too - no simple way to do that with the plugin.
    – OverToasty
    Jan 18, 2014 at 20:45
  • @OverToasty check out the new commit, forks make some great changes Feb 12, 2014 at 8:00
4

xCode 6 beta 4 should support MARK, TODO and FIXME landmarks.

Xcode now supports //MARK:, //TODO: and //FIXME landmarks to annotate your code and lists them in the jump bar. (14768427)!

0
2

Just a heads up, but I've noticed the TODO:'s do not work within blocks of any kind. Just move it right above or below your block.

0

This is the script I use as an added build phase, note it excludes files pulled-in via Carthage (very annoying to get these as well otherwise since its not 'your' code) :

TAGS="WARNING:|TODO:"
echo "searching ${SRCROOT} for ${TAGS}"
find "${SRCROOT}" \( -name "*.swift" \) -not -path "${SRCROOT}/Carthage/*" -print0 | xargs -0 egrep --with-filename --line-number --only-matching "($TAGS).*\$" | perl -p -e "s/($TAGS)/ warning: \$1/"

Works well on xCode 9.3 with Swift 4

0

If you want to continue developing but need to ensure your app doesn't get released with a leftover //FIXME: you can do the following as an alternative.

Define this somewhere in one of your headers:

#if DEBUG
#define FIXME 0;
#endif

This definition lets your app build for debug but prevents it from being archived for release.

Now you can use FIXME anywhere you would've used the comment.

Ex: NSNumber *magicNumber = 7; FIXME

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge that you have read and understand our privacy policy and code of conduct.

Not the answer you're looking for? Browse other questions tagged or ask your own question.