I'm new to fossil and have encountered something that is throwing me for a loop.

If I am in the top-level of my project and do a diff, I see what I would expect.

$ fossil diff src/libcommon/cqt.h
Index: src/libcommon/cqt.h
==================================================================
--- src/libcommon/cqt.h
+++ src/libcommon/cqt.h
@@ -1,7 +1,9 @@
 #ifndef CQT_H
 #define CQT_H

 void cqt_init(void);
+void cqt_alloc(void);
+void cqt_release(void);
 void cqt_compute(float *data_in, float *data_out, uint32_t count);

 #endif /* CQT_H */

But if I change to the libcommon directory and do a diff there, it reports the file as MISSING.

$ cd src/libcommon
$ fossil diff cqt.h
MISSING  src/libcommon/cqt.h

A verbose diff sheds a little light on what is happening.

$ fossil diff -v cqt.h
MISSING  src/libcommon/cqt.h
Index: src/libcommon/cqt.h
==================================================================
--- src/libcommon/cqt.h
+++ /dev/null
@@ -1,7 +0,0 @@
-#ifndef CQT_H
-#define CQT_H
-
-void cqt_init(void);
-void cqt_compute(float *data_in, float *data_out, uint32_t count);
-
-#endif /* CQT_H */

Fossil is using the relative path based on the project's top-level (src/libcommon/cqt.h), even though it is being called from the src/libcommon subdirectory and should be using (./cqt.h).

Is this the intended behavior? I'm running version 2.18 on a Mac.

But if I change to the libcommon directory and do a diff there, it reports the file as MISSING. ... I'm running version 2.18 on a Mac.

That's a feature i've used almost daily for years and have never seen what you're describing. This is presumably a bit of platform-specific weirdness. Perhaps one of our other Mac users can confirm whether they can reproduce this. On Linux it's working as expected (presumably how you expect it to)...

[stephan@nuc:~/fossil/libfossil/include/fossil-scm]$ echo '// test' >> vpath.h 
[stephan@nuc:~/fossil/libfossil/include/fossil-scm]$ f diff vpath.h 
Index: include/fossil-scm/vpath.h
==================================================================
--- include/fossil-scm/vpath.h
+++ include/fossil-scm/vpath.h
@@ -234,5 +234,6 @@
 #if defined(__cplusplus)
 } /*extern "C"*/
 #endif
 #endif
 /* ORG_FOSSIL_SCM_FSL_VPATH_H_INCLUDED */
+// test

I'm not able to reproduce the problem. When I try it, Fossil seems to behave as the OP suggests it should.

I didn't think I was doing anything unusual. Any thoughts as to what I can check to see why my set up is behaving the way it is?

I checked another project I have and it too does not behave as expected. So whatever I've done, at least I'm consistent.

Are you using symbolic links? If so, that might be part of the confusion.

What does the output of "fossil changes" show?

Did you build Fossil yourself, or are you using somebody else's build that might have bootleg patches?

I am not using symbolic links.

"fossil changes" seems correct. The following is from my src/libcommon directory.

$ fossil changes
EDITED     ../Astra/init.c
EDITED     cqt.c
EDITED     cqt.h
EDITED     fft.c
EDITED     fft.h
EDITED     hit_detect.c
EDITED     hit_detect.h
EDITED     ../libeffects/effect_bullets.c
EDITED     ../libeffects/effect_cqt.c
EDITED     ../libeffects/effect_fft.c
EDITED     ../libeffects/effect_layers.c
EDITED     ../libeffects/effect_midi_tracker.c
EDITED     ../libeffects/effect_missiles.c
EDITED     ../libeffects/effect_napalm.c
EDITED     ../libeffects/effect_rainbow.c

I installed fossil via MacPorts. It doesn't look like they added any local patches.

https://github.com/macports/macports-ports/tree/master/devel/fossil

May be their compilation flags ?

configure.args-append       --with-tcl=${prefix}/lib \
                            --with-openssl=[openssl::install_area] \
                            --with-zlib=${prefix}/lib \
                            --with-th1-docs \
                            --with-th1-hooks \
                            --with-exec-rel-paths \
                            --json

Specifically: "--with-exec-rel-paths"

Does "fossil diff --webpage >out1.html && open out1.html" work for you?

What about "fossil diff --webpage -y >out2.html && open out2.html"?

This might be it. If I run

fossil diff --with-exec-abs-paths

from my src/libcommon directory, I get the output I expect.

Neither of these work. They both diff against /dev/null.

If I add --exec-abs-paths to the diff commands, it does work.

I don't even know what --with-exec-rel-paths does. That's something somebody else has added.

From common on auto.def

or from the equivalent setting

It seems to be to use relative path by default when calling external diff program.

It looks like it comes down to this (from diff_against_disk in diffcmd.c):

const char *zPathname = db_column_text(&q,0);
int isDeleted = db_column_int(&q, 1);
int isChnged = db_column_int(&q,2);
int isNew = db_column_int(&q,3);
int srcid = db_column_int(&q, 4);
int isLink = db_column_int(&q, 5);
const char *zFullName;
int showDiff = 1;
Blob fname;

if( !file_dir_match(pFileDir, zPathname) ) continue;
if( determine_exec_relative_option(0) ){
  blob_zero(&fname);
  file_relative_name(zPathname, &fname, 1);
}else{
  blob_set(&fname, g.zLocalRoot);
  blob_append(&fname, zPathname, -1);
}

The --with-exec-rel-paths configuration option instructs determine_exec_relative_option() to default to returning 1. This looks reasonable to me. Maybe the diff is always relative to the top-level directory and not the current working directory? And if that's the case, I'm not sure how exec-rel-path would be useful.

Anyway, hopefully MacPorts will make the configuration change and it will be a moot issue.

And if that's the case, I'm not sure how exec-rel-path would be useful.

I don't know either, I always use vimdiff as external diff tools, and I never had the need to use this --with-exec-rel-paths option. May be other tools require it ? I don't know.