TempleOSCD_140715.ISO

Doc/Quirks.TXT

@@ -1,8 +1,8 @@
-$FG,5$$TX+CX,"TempleOS Quirks"$$FG$
+$FG,5$$TX+CX,"Quirks"$$FG$
 
 $WW,1$* You run a risk of problems if you do file operations on the same files simultaneously because there is $BK,1$no file sharing/locking mechanism$BK,0$.  Generally, the last write wins.
 
-* When using $FG,2$FAT32$FG$, TempleOS does not generate unique short-entry names.  Not all $FG,2$FAT32$FG$ filenames are valid TempleOS names and it will complain.  Do not access $FG,2$FAT32$FG$ drives not dedicated to TempleOS.  Disable them with $LK,"DrvEnable",A="MN:DrvEnable"$(OFF), or they will generate error messages.  $FG,2$FAT32$FG$ involves a long and short name for each file.  TempleOS isn't so good at making distinct short names, so don't make files with same 11 characters, or you're asking for trouble when accessing from Windows.
+* When using $FG,2$FAT32$FG$, TempleOS does not generate unique short-entry names, the ones with the $FG,2$~$FG$s.  Not all $FG,2$FAT32$FG$ filenames are valid TempleOS names and it will complain.  Do not access $FG,2$FAT32$FG$ drives not dedicated to TempleOS.  Disable them with $LK,"DrvEnable",A="MN:DrvEnable"$(OFF), or they will generate error messages.  $FG,2$FAT32$FG$ involves a long and short name for each file.
 
 * The stk does not grow because virtual mem is not used.  I recommend allocating large local vars from the heap.  You can change $LK,"DFT_STK",A="MN:DFT_STK"$ and recompile $FG,2$Kernel$FG$ or request more when doing a $LK,"Spawn",A="MN:Spawn"$().
 
@@ -18,7 +18,7 @@ $WW,1$* You run a risk of problems if you do file operations on the same files s
 $ID,2$
 A) $LK,"DocBottom",A="MN:DocBottom"$() followed by $LK,"DocClear",A="MN:DocClear"$() to clear the $LK,"CDoc",A="MN:CDoc"$ so it has no active widgets.
 
-B) Disable window mgr button click checking with $FG,4$Fs->win_inhibit$FG$ set to mask $LK,"WIF_IP_L",A="MN:WIF_IP_L"$|$LK,"WIF_IP_L_D",A="MN:WIF_IP_L_D"$|$LK,"WIF_IP_R",A="MN:WIF_IP_R"$|$LK,"WIF_IP_R_D",A="MN:WIF_IP_R_D"$.  This inhibits window mgr operations but still generates messages from button clicks.
+B) Disable window mgr button click checking with $FG,4$Fs->win_inhibit$FG$ set to mask $LK,"WIF_SELF_IP_L",A="MN:WIF_SELF_IP_L"$|$LK,"WIF_FOCUS_TASK_IP_L_D",A="MN:WIF_FOCUS_TASK_IP_L_D"$|$LK,"WIF_SELF_IP_R",A="MN:WIF_SELF_IP_R"$|$LK,"WIF_FOCUS_TASK_IP_R_D",A="MN:WIF_FOCUS_TASK_IP_R_D"$.  This inhibits window mgr operations but still generates messages from button clicks.
 $ID,-2$
 * $FG,2$switch/case$FG$ statements allocate a single jump table--do not use with wide, sparse ranges of case values.
 
@@ -32,13 +32,16 @@ $ID,-2$
 
 * The assembler's error msgs are often off by a line and undefines are cryptic.
 
-* The last semicolon on the cmd line is converted to a dbl semicolon because the compiler looks ahead before doing a cmd.  This normally has no negative effect, but when entering "$FG,2$if$FG$" statements with "$FG,2$else$FG$" clauses it presents problems.
+* The last semicolon on the cmd line is converted to a dbl semicolon because the compiler looks ahead before doing a cmd.  This normally has no negative effect, but when entering $FG,2$if$FG$ statements with $FG,2$else$FG$ clauses it presents problems.
 
 * You can do a $FG,2$class$FG$ fwd reference by using $FG,2$extern$FG$ on the first declaration, but you can only do ptr references to the $FG,2$class$FG$.
 
 * When doing something like
-$FG,4$$ID,2$$ID,2$U16 *_w=0xF0000000;
-*_w|=0x8000;
+$FG,2$$ID,2$$ID,2$U0 Main()
+{
+  U16 *_w=0xA0000;
+  *_w|=0x8000;
+}
 $ID,-2$$FG$The $FG,2$|=$FG$ will be coded as a $FG,2$U32 Bts$FG$ instruction resulting in a $FG,2$U32$FG$ access instead of a $FG,2$U16$FG$ access.  This affects some hardware operations.
 $ID,-2$
-* Compiler warning or error message line numbers will be off if you have a block of word-wrapped comments.  You might press $FG,2$<CTRL-T>$FG$ before doing an editor goto-line-number command.
+* Compiler warning or error message line numbers will be off if you have a block of word-wrapped comments.  You might press $FG,2$<CTRL-t>$FG$ before doing an editor goto-line-number command.