6.6.5 Path, File and Folder Name Restrictions

You should only use the following ASCII characters for path, file and folder names:

  • A through Z
  • a through z
  • 0 through 9
  • underscore: _
  • dash: -
  • period: .

Makefile

If you have files or directories within the project directory using either the () or [] characters ( e.g., t (1).c ), or if you use absolute paths to directories with these characters, the characters will cause the "no rule to make target" problem.

The workaround is to avoid doing it at this time. System libraries can be added through the project properties and therefore, do not need to be added to the project.

Cross-Platform Operating Systems

If you plan on using MPLAB X IDE on different platforms (Windows OS, Linux OS or macOS), be aware of these issues:

  • Use the forward slash “/” in relative paths. The backslash “\” works only on Windows OS platforms. Example: #include headers/myheader.h.
  • Linux OS is case-sensitive, so generictypedefs.h is not the same as GenericTypeDefs.h.

Windows Operation System

Windows operating systems have a maximum path length of 260 characters. An explanation from Microsoft is found here:

msdn.microsoft.com/en-us/library/windows/desktop/aa365247(v=vs.85).aspx

Although Windows will attempt to stop you from creating path lengths that are too long, it is possible to do this (from certain applications, cutting-and-pasting, etc.) If a project source file uses such a path, the project will not build correctly. Additionally, there is a command-line limitation for Windows OS of 8191 characters.

For workarounds, see 12.5 Errors.