[Scummvm-git-logs] scummvm master -> 4a191f6551825d971ce2b63424f2f15f1e858624

sev- noreply at scummvm.org
Mon Apr 3 23:09:31 UTC 2023


This automated email contains information about 1 new commit which have been
pushed to the 'scummvm' repo located at https://github.com/scummvm/scummvm .

Summary:
4a191f6551 DIRECTOR: JANITORIAL: Made all Xlibs usage comments uniform


Commit: 4a191f6551825d971ce2b63424f2f15f1e858624
    https://github.com/scummvm/scummvm/commit/4a191f6551825d971ce2b63424f2f15f1e858624
Author: Eugene Sandulenko (sev at scummvm.org)
Date: 2023-04-04T01:09:07+02:00

Commit Message:
DIRECTOR: JANITORIAL: Made all Xlibs usage comments uniform

Changed paths:
    engines/director/lingo/xlibs/applecdxobj.cpp
    engines/director/lingo/xlibs/askuser.cpp
    engines/director/lingo/xlibs/barakeobj.cpp
    engines/director/lingo/xlibs/batqt.cpp
    engines/director/lingo/xlibs/blitpict.cpp
    engines/director/lingo/xlibs/cdromxobj.cpp
    engines/director/lingo/xlibs/developerStack.cpp
    engines/director/lingo/xlibs/dialogsxobj.cpp
    engines/director/lingo/xlibs/dpwavi.cpp
    engines/director/lingo/xlibs/dpwqtw.cpp
    engines/director/lingo/xlibs/draw.cpp
    engines/director/lingo/xlibs/ednox.cpp
    engines/director/lingo/xlibs/fedracul.cpp
    engines/director/lingo/xlibs/feimasks.cpp
    engines/director/lingo/xlibs/feiprefs.cpp
    engines/director/lingo/xlibs/fileexists.cpp
    engines/director/lingo/xlibs/findfolder.cpp
    engines/director/lingo/xlibs/findsys.cpp
    engines/director/lingo/xlibs/flushxobj.cpp
    engines/director/lingo/xlibs/fplayxobj.cpp
    engines/director/lingo/xlibs/jitdraw3.cpp
    engines/director/lingo/xlibs/labeldrvxobj.cpp
    engines/director/lingo/xlibs/memoryxobj.cpp
    engines/director/lingo/xlibs/miscx.cpp
    engines/director/lingo/xlibs/moovxobj.cpp
    engines/director/lingo/xlibs/movemousexobj.cpp
    engines/director/lingo/xlibs/orthoplayxobj.cpp
    engines/director/lingo/xlibs/palxobj.cpp
    engines/director/lingo/xlibs/popupmenuxobj.cpp
    engines/director/lingo/xlibs/qtmovie.cpp
    engines/director/lingo/xlibs/registercomponent.cpp
    engines/director/lingo/xlibs/serialportxobj.cpp
    engines/director/lingo/xlibs/soundjam.cpp
    engines/director/lingo/xlibs/spacemgr.cpp
    engines/director/lingo/xlibs/videodiscxobj.cpp
    engines/director/lingo/xlibs/volumelist.cpp
    engines/director/lingo/xlibs/widgetxobj.cpp
    engines/director/lingo/xlibs/winxobj.cpp
    engines/director/lingo/xlibs/xio.cpp
    engines/director/lingo/xlibs/xplayanim.cpp
    engines/director/lingo/xlibs/yasix.cpp


diff --git a/engines/director/lingo/xlibs/applecdxobj.cpp b/engines/director/lingo/xlibs/applecdxobj.cpp
index c9e50a4be04..f3b4b3ae82c 100644
--- a/engines/director/lingo/xlibs/applecdxobj.cpp
+++ b/engines/director/lingo/xlibs/applecdxobj.cpp
@@ -25,61 +25,63 @@
  * The Daedalus Encounter
  *
  *************************************/
-/* -! Category compactDisc
-* -! Title AppleCD SC
-* -! Protocol Ortho-Play 1.6.1
-* --© 1990,1991 MacroMind, Inc. Alan McNeil
-* ------------------------------------------------------
-* --AppleCD SC, version 2.5.6
-* --Mar  7 1994
-* --including AppleCD SC Plus volume control
-* ------------------------------------------------------
-* X  mNew
-* X  mDispose
-* --
-* I  mGetMaxNodes
-* SI  mGetNodeTitle NodeNum
-* II  mSelectNode NodeNum
-* --
-* I  mService
-* I  mGetValue
-* I  mCancel
-* S  mExplain
-* I  mIdle
-* --
-* X  mReadStatus
-* X  mReadPos
-* XI mSearchTo position
-* X  mPlay
-* X  mStill
-* X  mStop
-* X  mScanForward
-* X  mScanReverse
-* X  mEject
-* --
-* I  mGetFirstTrack
-* I  mGetLastTrack
-* II  mGetFirstFrame tracknum
-* II  mGetLastFrame tracknum
-* I  mGetTrack
-* XII mAudioEnable number number
-* I  mGetFrameResolution
-* --
-* II mSetInPoint frame
-* II mSetOutPoint frame
-* II mSetDuration frames
-* --
-* X  mPlayCue
-* X  mPlaySegment
-* --
-* S    mTitle
-* SI   mTrackName tracknum
-* IS   mSetTitle string
-* IIS  mSetTrackName tracknum string
-* II   mGetTrackType tracknum
-* III  mSetVolume leftVolume rightVolume
-* II   mGetVolume leftFlag
-* --
+
+/*
+   -! Category compactDisc
+ * -! Title AppleCD SC
+ * -! Protocol Ortho-Play 1.6.1
+ * --© 1990,1991 MacroMind, Inc. Alan McNeil
+ * ------------------------------------------------------
+ * --AppleCD SC, version 2.5.6
+ * --Mar  7 1994
+ * --including AppleCD SC Plus volume control
+ * ------------------------------------------------------
+ * X  mNew
+ * X  mDispose
+ * --
+ * I  mGetMaxNodes
+ * SI  mGetNodeTitle NodeNum
+ * II  mSelectNode NodeNum
+ * --
+ * I  mService
+ * I  mGetValue
+ * I  mCancel
+ * S  mExplain
+ * I  mIdle
+ * --
+ * X  mReadStatus
+ * X  mReadPos
+ * XI mSearchTo position
+ * X  mPlay
+ * X  mStill
+ * X  mStop
+ * X  mScanForward
+ * X  mScanReverse
+ * X  mEject
+ * --
+ * I  mGetFirstTrack
+ * I  mGetLastTrack
+ * II  mGetFirstFrame tracknum
+ * II  mGetLastFrame tracknum
+ * I  mGetTrack
+ * XII mAudioEnable number number
+ * I  mGetFrameResolution
+ * --
+ * II mSetInPoint frame
+ * II mSetOutPoint frame
+ * II mSetDuration frames
+ * --
+ * X  mPlayCue
+ * X  mPlaySegment
+ * --
+ * S    mTitle
+ * SI   mTrackName tracknum
+ * IS   mSetTitle string
+ * IIS  mSetTrackName tracknum string
+ * II   mGetTrackType tracknum
+ * III  mSetVolume leftVolume rightVolume
+ * II   mGetVolume leftFlag
+ * --
  */
 
 #include "director/director.h"
diff --git a/engines/director/lingo/xlibs/askuser.cpp b/engines/director/lingo/xlibs/askuser.cpp
index 74d998615c2..5b48f660d1c 100644
--- a/engines/director/lingo/xlibs/askuser.cpp
+++ b/engines/director/lingo/xlibs/askuser.cpp
@@ -36,12 +36,13 @@ namespace Director {
  * DEVO Presents: Adventures of the Smart Patrol
  *
  **************************************************/
+
 /*
--- AskUser XObject. Copyright 1996 Inscape v1.0 24May96 BDL
-AskUser
-I      mNew                                                                --Creates a new instance
-X      mDispose                                                            --Disposes XObject instance
-SSSS               mAsk                                                                                          --Data to display in the message box.
+ * -- AskUser XObject. Copyright 1996 Inscape v1.0 24May96 BDL
+ * AskUser
+ * I      mNew                                                                --Creates a new instance
+ * X      mDispose                                                            --Disposes XObject instance
+ * SSSS               mAsk                                                                                          --Data to display in the message box.
 */
 
 const char *AskUser::xlibName = "AskUser";
@@ -94,7 +95,7 @@ void AskUser::m_ask(int nargs) {
 		g_lingo->dropStack(nargs);
 		g_lingo->push(Datum("Ok"));
 		return;
-	}	
+	}
 	Datum text = g_lingo->pop();
 	Datum caption = g_lingo->pop(); // ScummVM doesn't have a title for message boxes, not used
 	Datum mbType = g_lingo->pop();
diff --git a/engines/director/lingo/xlibs/barakeobj.cpp b/engines/director/lingo/xlibs/barakeobj.cpp
index 7efdf2ce26e..f7d78a3d194 100644
--- a/engines/director/lingo/xlibs/barakeobj.cpp
+++ b/engines/director/lingo/xlibs/barakeobj.cpp
@@ -26,13 +26,13 @@
  *
  *************************************/
 /*
-  -- Picter, a simple demo XObject, v1.0
-  I           mNew
-  XIII        mGpal, h, l, s
-  XIIIIII     mLine, y1, y2, y3, y4, y5, c
-  II          mGetDate, value
-  X           mClear
-*/
+ * -- Picter, a simple demo XObject, v1.0
+ * I           mNew
+ * XIII        mGpal, h, l, s
+ * XIIIIII     mLine, y1, y2, y3, y4, y5, c
+ * II          mGetDate, value
+ * X           mClear
+ */
 
 #include "director/director.h"
 #include "director/lingo/lingo.h"
diff --git a/engines/director/lingo/xlibs/batqt.cpp b/engines/director/lingo/xlibs/batqt.cpp
index 68003375aa6..819851fd1a6 100644
--- a/engines/director/lingo/xlibs/batqt.cpp
+++ b/engines/director/lingo/xlibs/batqt.cpp
@@ -19,7 +19,14 @@
  *
  */
 
-/**
+/*************************************
+ *
+ * USED IN:
+ * teamxtreme2-win
+ *
+ *************************************/
+
+/*
  * -- BatQt quicktime factory. 9Aug94 RNB
  * BatQt
  * I      mNew                    --Creates a new instance of the XObject
@@ -43,8 +50,6 @@
  * II     mRemoveCallback         -- Removes a callback for the movie
  * I      mResetCallbacks         -- Resets the sent status of the callbacks
  * XS     mSetBatch               -- Applies a set of batch commands
- *
- * USED IN: teamxtreme2-win
  */
 
 #include "director/director.h"
diff --git a/engines/director/lingo/xlibs/blitpict.cpp b/engines/director/lingo/xlibs/blitpict.cpp
index 107dd25725c..ccbb1f91c16 100644
--- a/engines/director/lingo/xlibs/blitpict.cpp
+++ b/engines/director/lingo/xlibs/blitpict.cpp
@@ -19,7 +19,14 @@
  *
  */
 
-/**
+/*************************************
+ *
+ * USED IN:
+ * teamxtreme2-win
+ *
+ *************************************/
+
+/*
  *  -- BlitPict effects factory. 29Jun94 RNB
  * BlitPict
  * I                mNew                --Creates a new instance of the XObject
@@ -32,8 +39,6 @@
  * SOIIII           mCopy               --Initializes from an existing object
  * IIIIIOIIIIIIII   mDraw               --Draws to a destinitation
  * IIIIIIIIIIII     mSparkle            --Draws a sparkle from a bitmap
- *
- * USED IN: teamxtreme2-win
  */
 
 #include "director/director.h"
diff --git a/engines/director/lingo/xlibs/cdromxobj.cpp b/engines/director/lingo/xlibs/cdromxobj.cpp
index 041fecdd36b..4ab66d58d0b 100644
--- a/engines/director/lingo/xlibs/cdromxobj.cpp
+++ b/engines/director/lingo/xlibs/cdromxobj.cpp
@@ -19,139 +19,146 @@
  *
  */
 
+/*************************************
+ *
+ * USED IN:
+ * The Apartment 2.0
+ *
+ *************************************/
+
 /*
-  --AppleAudioCD, CDAudio, 1.0, 4/3/90
-  --
-  --© 1989, 1990 MacroMind, Inc.
-  -- by Jeff Tanner
-  --
-  ------------------------------------------------------
-  ------------------------------------------------------
-  --  An Apple CD SC Player must be mounted
-  --      in order for this XObject to operate properly.
-  --      The easiest way to check for mounting is to
-  --      check the desktop for the CD icon.
-  ------------------------------------------------------
-  ------------------------------------------------------
-  -- This XObject recognizes only the first player in the SCSI chain .
-  ------------------------------------------------------
-  ------------------------------------------------------
-  --=METHODS=--
-  X   mNew --Creates a new instance of the XObject.
-  X   mDispose --Disposes of the instance.
-  S   mName --Returns name of the XObject.
-  ------------------------------------------------------
-  ------------------------------------------------------
-  -- PLAY CD METHODS:
-  S   mPlay --Plays current track from the beginning.
-  SI mPlayTrack, trackNum --Plays the specified track from the beginning.
-  SS   mPlayName, trackName --Plays by track name.
-  --      Note: The full pathname is unnecessary.
-  --      The track names for tracks 1 - 9 are
-  --          "TRACK<space><space>trackNum" and for tracks 10 to 99 are
-  --          "TRACK<space>trackNum".
-  SIII mPlayAbsTime, minute, second, frame --Starts play at absolute time position on current CD-ROM.
-  --
-  SIIIIII mPlaySegment, startMin, startSec, startFrm, stopMin, stopSec, stopFrm
-  --          < startMin, startSec, startFrm > - Start time
-  --          < stopMin, stopSec, stopFrm > - Stop time
-  SII  mAskPlay, leftDialog, topDialog        --With a file dialog box,
-  --                                  selects an Audio track to play.
-  --          < leftDialog, topDialog > - Where to place the file dialog box
-  ------------------------------------------------------
-  S   mStepFwd --Steps forward one track and Plays.
-  S   mStepBwd --Steps back one track and Plays.
-  --
-  S    mPause --Pauses the player.
-  --      When this method is called a second time,
-  --      the player will continue in normal play mode.
-  S    mContinue --Continues the mode prior to calling mPause.
-  --
-  S    mStop                              --Stops play.
-  SI   mStopTrack, trackNum               --Stops when the selected track finishes playing.
-  SIII mStopAbsTime, minute, second, frame --Stops play at a specified absolute time position.
-  S    mRemoveStop -- Removes stop conditions.
-  --          Stop conditions are set with these methods:
-  --                  mPlaySegment
-  --                  mStopTrack
-  --                  mStopAbsTime
-  --
-  S    mEject --Ejects CD-ROM from drive.
-  --
-  ------------------------------------------------------
-  ------------------------------------------------------
-  -- STATUS METHODS:
-  S    mStatus --Returns status of Audio CD player.
-  --      Returns message strings:
-  --          Audio play in progress
-  --          Audio pause in operation
-  --          Audio muting on
-  --          Audio play operation completed
-  --          Error occurred during audio play
-  --          Not currently playing
-  --
-  S    mPlayMode      --Returns a play mode from audio track.
-  --      The play mode describes how to play the audio track.
-  --      Returns message strings:
-  --          Muting on (no audio)
-  --          Right channel through right channel only
-  --          Left channel through right channel only
-  --          Left and right channels through right channel only
-  --          Right channel through left channel only
-  --          Right channel through left and right channel
-  --          Right channel through left channel,
-  --              Left channel through right channel
-  --          Right channel through left channel,
-  --              Left and right channels through right channel
-  --          Left channel through left channel only
-  --          Left channel through left channel,
-  --              Right channel through right channel (Stereo)
-  --          Left channel through left and right channel
-  --          Left channel through left channel,
-  --              Left and right channels through right channel
-  --          Left and right channels through left channel only
-  --          Left and right channels through left channel,
-  --              Right channel through right channel
-  --          Left and right channels through left channel,
-  --              Left channel through right channel
-  --          Left and right channels through
-  --              both left channel and right channel (Mono)
-  --
-  S    mCurrentFormat         --Returns the format of the current track.
-  --      Returns message strings:
-  --          2 audio channels without preemphasis
-  --          2 audio channels with preemphasis
-  --          4 audio channels without preemphasis
-  --          4 audio channels with preemphasis
-  --          Data track
-  --
-  ------------------------------------------------------
-  ------------------------------------------------------
-  --
-  I    mCurrentTrack --Returns number of the current track.
-  S    mCurrentTime  --Returns the current absolute time (min:sec:frm).
-  --
-  I    mFirstTrack  -- Returns first track number on current CD-ROM.
-  I    mLastTrack  -- Returns last track number on current CD-ROM.
-  S    mTotalTime -- Returns total time on current CD-ROM (min:sec:frm)
-  ------------------------------------------------------
-  ------------------------------------------------------
-  -- SCANNING METHODS:
-  -- Starting at a specific time:
-  --   min, sec, and frm parameters are to indicate
-  --      the absolute time to start scan.
-  --   monitorP - if true, it will stop scan moment mouse
-  --      is released, and continue playing at current position.
-  --      However, this will inhibit all other events.
-  --      Otherwise use mStopScan method.
-  SIIII mScanFwd min, sec, frm, monitorP -- Fast forward scan
-  SIIII mScanBwd min, sec, frm, monitorP -- Fast reverse scan
-  --
-  S   mStopScan --Stops scan and continues playing at current position.
-  --
-  --  End description of AppleAudioCD XObject methods.
-  ------------------------------------------------------
-  ------------------------------------------------------
+ * --AppleAudioCD, CDAudio, 1.0, 4/3/90
+ * --
+ * --© 1989, 1990 MacroMind, Inc.
+ * -- by Jeff Tanner
+ * --
+ * ------------------------------------------------------
+ * ------------------------------------------------------
+ * --  An Apple CD SC Player must be mounted
+ * --      in order for this XObject to operate properly.
+ * --      The easiest way to check for mounting is to
+ * --      check the desktop for the CD icon.
+ * ------------------------------------------------------
+ * ------------------------------------------------------
+ * -- This XObject recognizes only the first player in the SCSI chain .
+ * ------------------------------------------------------
+ * ------------------------------------------------------
+ * --=METHODS=--
+ * X   mNew --Creates a new instance of the XObject.
+ * X   mDispose --Disposes of the instance.
+ * S   mName --Returns name of the XObject.
+ * ------------------------------------------------------
+ * ------------------------------------------------------
+ * -- PLAY CD METHODS:
+ * S   mPlay --Plays current track from the beginning.
+ * SI mPlayTrack, trackNum --Plays the specified track from the beginning.
+ * SS   mPlayName, trackName --Plays by track name.
+ * --      Note: The full pathname is unnecessary.
+ * --      The track names for tracks 1 - 9 are
+ * --          "TRACK<space><space>trackNum" and for tracks 10 to 99 are
+ * --          "TRACK<space>trackNum".
+ * SIII mPlayAbsTime, minute, second, frame --Starts play at absolute time position on current CD-ROM.
+ * --
+ * SIIIIII mPlaySegment, startMin, startSec, startFrm, stopMin, stopSec, stopFrm
+ * --          < startMin, startSec, startFrm > - Start time
+ * --          < stopMin, stopSec, stopFrm > - Stop time
+ * SII  mAskPlay, leftDialog, topDialog        --With a file dialog box,
+ * --                                  selects an Audio track to play.
+ * --          < leftDialog, topDialog > - Where to place the file dialog box
+ * ------------------------------------------------------
+ * S   mStepFwd --Steps forward one track and Plays.
+ * S   mStepBwd --Steps back one track and Plays.
+ * --
+ * S    mPause --Pauses the player.
+ * --      When this method is called a second time,
+ * --      the player will continue in normal play mode.
+ * S    mContinue --Continues the mode prior to calling mPause.
+ * --
+ * S    mStop                              --Stops play.
+ * SI   mStopTrack, trackNum               --Stops when the selected track finishes playing.
+ * SIII mStopAbsTime, minute, second, frame --Stops play at a specified absolute time position.
+ * S    mRemoveStop -- Removes stop conditions.
+ * --          Stop conditions are set with these methods:
+ * --                  mPlaySegment
+ * --                  mStopTrack
+ * --                  mStopAbsTime
+ * --
+ * S    mEject --Ejects CD-ROM from drive.
+ * --
+ * ------------------------------------------------------
+ * ------------------------------------------------------
+ * -- STATUS METHODS:
+ * S    mStatus --Returns status of Audio CD player.
+ * --      Returns message strings:
+ * --          Audio play in progress
+ * --          Audio pause in operation
+ * --          Audio muting on
+ * --          Audio play operation completed
+ * --          Error occurred during audio play
+ * --          Not currently playing
+ * --
+ * S    mPlayMode      --Returns a play mode from audio track.
+ * --      The play mode describes how to play the audio track.
+ * --      Returns message strings:
+ * --          Muting on (no audio)
+ * --          Right channel through right channel only
+ * --          Left channel through right channel only
+ * --          Left and right channels through right channel only
+ * --          Right channel through left channel only
+ * --          Right channel through left and right channel
+ * --          Right channel through left channel,
+ * --              Left channel through right channel
+ * --          Right channel through left channel,
+ * --              Left and right channels through right channel
+ * --          Left channel through left channel only
+ * --          Left channel through left channel,
+ * --              Right channel through right channel (Stereo)
+ * --          Left channel through left and right channel
+ * --          Left channel through left channel,
+ * --              Left and right channels through right channel
+ * --          Left and right channels through left channel only
+ * --          Left and right channels through left channel,
+ * --              Right channel through right channel
+ * --          Left and right channels through left channel,
+ * --              Left channel through right channel
+ * --          Left and right channels through
+ * --              both left channel and right channel (Mono)
+ * --
+ * S    mCurrentFormat         --Returns the format of the current track.
+ * --      Returns message strings:
+ * --          2 audio channels without preemphasis
+ * --          2 audio channels with preemphasis
+ * --          4 audio channels without preemphasis
+ * --          4 audio channels with preemphasis
+ * --          Data track
+ * --
+ * ------------------------------------------------------
+ * ------------------------------------------------------
+ * --
+ * I    mCurrentTrack --Returns number of the current track.
+ * S    mCurrentTime  --Returns the current absolute time (min:sec:frm).
+ * --
+ * I    mFirstTrack  -- Returns first track number on current CD-ROM.
+ * I    mLastTrack  -- Returns last track number on current CD-ROM.
+ * S    mTotalTime -- Returns total time on current CD-ROM (min:sec:frm)
+ * ------------------------------------------------------
+ * ------------------------------------------------------
+ * -- SCANNING METHODS:
+ * -- Starting at a specific time:
+ * --   min, sec, and frm parameters are to indicate
+ * --      the absolute time to start scan.
+ * --   monitorP - if true, it will stop scan moment mouse
+ * --      is released, and continue playing at current position.
+ * --      However, this will inhibit all other events.
+ * --      Otherwise use mStopScan method.
+ * SIIII mScanFwd min, sec, frm, monitorP -- Fast forward scan
+ * SIIII mScanBwd min, sec, frm, monitorP -- Fast reverse scan
+ * --
+ * S   mStopScan --Stops scan and continues playing at current position.
+ * --
+ * --  End description of AppleAudioCD XObject methods.
+ * ------------------------------------------------------
+ * ------------------------------------------------------
  */
 
 #include "backends/audiocd/audiocd.h"
diff --git a/engines/director/lingo/xlibs/developerStack.cpp b/engines/director/lingo/xlibs/developerStack.cpp
index a18bf0501c1..552ca3648d8 100644
--- a/engines/director/lingo/xlibs/developerStack.cpp
+++ b/engines/director/lingo/xlibs/developerStack.cpp
@@ -24,6 +24,13 @@
 #include "director/director.h"
 #include "director/lingo/xlibs/developerStack.h"
 
+/*************************************
+ *
+ * USED IN:
+ * overringunder: Over-Ring-Under
+ *
+ *************************************/
+
 /*************************************
  *
  * Developer Stack 1.3r
@@ -92,13 +99,7 @@
   */
 
 
-/*************************************
- *
- * XCMD: SetVolume
- *
- * USED IN:
- * overringunder: Over-Ring-Under
- *
+/*
  * This XCMD sets the current volume level of the Macintosh.
  *
  * This XCMD is ©1988 by Steve Drazga and all rights are reserved.
diff --git a/engines/director/lingo/xlibs/dialogsxobj.cpp b/engines/director/lingo/xlibs/dialogsxobj.cpp
index 404dbb545a3..90d678fb19d 100644
--- a/engines/director/lingo/xlibs/dialogsxobj.cpp
+++ b/engines/director/lingo/xlibs/dialogsxobj.cpp
@@ -25,6 +25,7 @@
 * Total Distortion
 *
 *************************************/
+
 /*
  * -- Dialogs XObject. Written by Scott Kildall. Copyright (c) Red Eye  Software, December 11th, 1994.
  * Compuserve:72703,451 AOL:KILDALL  APPLELINK:S.KILDALL
diff --git a/engines/director/lingo/xlibs/dpwavi.cpp b/engines/director/lingo/xlibs/dpwavi.cpp
index 497428f6f53..f67b7a76252 100644
--- a/engines/director/lingo/xlibs/dpwavi.cpp
+++ b/engines/director/lingo/xlibs/dpwavi.cpp
@@ -19,7 +19,14 @@
  *
  */
 
-/**
+/*************************************
+*
+* USED IN:
+* jman-win
+*
+*************************************/
+
+/*
  *  -- AVI External Factory. 02oct92 JT
  * DPWAVI
  * X  +mStartup -- First time init
@@ -27,9 +34,6 @@
  * XI     mNew qtPacket -- create a window
  * X      mDispose -- close and dispose window
  * XII    mVerb msg, qtPacker -- do something
- *
- *
- * USED IN: jman-win
  */
 
 #include "director/director.h"
diff --git a/engines/director/lingo/xlibs/dpwqtw.cpp b/engines/director/lingo/xlibs/dpwqtw.cpp
index 7019da4716c..0090b6818b9 100644
--- a/engines/director/lingo/xlibs/dpwqtw.cpp
+++ b/engines/director/lingo/xlibs/dpwqtw.cpp
@@ -19,6 +19,13 @@
  *
  */
 
+/*************************************
+*
+* USED IN:
+* jman-win
+*
+*************************************/
+
 /**
  *  -- QuickTime for Windows Player External Factory. 02oct92 JT
  * DPWQTW
@@ -27,8 +34,6 @@
  * XI     mNew qtPacket -- create a window
  * X      mDispose -- close and dispose window
  * XII    mVerb msg, qtPacker -- do something
- *
- * USED IN: jman-win
  */
 
 #include "director/director.h"
diff --git a/engines/director/lingo/xlibs/draw.cpp b/engines/director/lingo/xlibs/draw.cpp
index 59fb295033c..68c10f2c0b2 100644
--- a/engines/director/lingo/xlibs/draw.cpp
+++ b/engines/director/lingo/xlibs/draw.cpp
@@ -25,59 +25,60 @@
  * מיץ פטל (Mitz Petel)
  *
  *************************************/
+
 /* -- Draw XObject version 1.0 beta
-Draw
--- (c) 1995 - Daniele Russo
--- New York University - Center for Digital Multimedia
-I        mNew                --Creates a new instance of the XObject.
---
-I        mDispose            --Disposes of an XObject instance.
---
-IIIII    mLine               --Draws a line.
---
-IIIII    mLineBrush          --Draws a line using a pen.
---
-IIIIII   mLineBrushTrans     --Draws a line using a transparent, multicolored pen.
---
-IIIIIII  mLineBrushCol       --Draws a line using a transparent pen.
---
-III      mFilterBMP          --Gets a picture containing all the pixels in an
---                             image excluding those which are of a particular color.
---                             The image to filter must be on the clipboard (as a BITMAP).
---
-III      mFilterDIB          --As above, but the image must be a DIB.
---
-III      mFilterBMP128       --Gets a picture containing all the pixels in an
---                             image whose color is within the lower/upper
---                             128. The image to filter must be on the clipboard
---                             (as a BITMAP).
---
-III      mFilterDIB128       --As above, but the image must be a DIB.
---
-III      mFilterBMPMakeGhostImage
---                             Gets a picture which has all the pixels that don't
---                             have the background color changed to a given color,
---                             specified by the caller. The image to filter must be
---                             on the clipboard (as a BITMAP).
---
-III      mFilterDIBMakeGhostImage
---                             As above, but the image must be a DIB.
---
-I        mEmptyClipboard     --Empties the clipboard. This method MUST be called
---                             after using the result of mFilterBMP and mFilterBMP128.
---
-IIII     mFill               --Fills an area starting at a specified pixel
---                             and defined by all the adjacent pixels with
---                             the same color.
---
-III      mGetColor           --Gets the color of a pixel on the stage. The
---                             result is the index of the color in Director's
---                             palette.
---
-IIIIII   mDrawRect           -- Draws a rectangle of a specified color.
---
-IIIIII   mDrawFrame          -- Draws a frame using a dotted pen.
-*/
+ * Draw
+ * -- (c) 1995 - Daniele Russo
+ * -- New York University - Center for Digital Multimedia
+ * I        mNew                --Creates a new instance of the XObject.
+ * --
+ * I        mDispose            --Disposes of an XObject instance.
+ * --
+ * IIIII    mLine               --Draws a line.
+ * --
+ * IIIII    mLineBrush          --Draws a line using a pen.
+ * --
+ * IIIIII   mLineBrushTrans     --Draws a line using a transparent, multicolored pen.
+ * --
+ * IIIIIII  mLineBrushCol       --Draws a line using a transparent pen.
+ * --
+ * III      mFilterBMP          --Gets a picture containing all the pixels in an
+ * --                             image excluding those which are of a particular color.
+ * --                             The image to filter must be on the clipboard (as a BITMAP).
+ * --
+ * III      mFilterDIB          --As above, but the image must be a DIB.
+ * --
+ * III      mFilterBMP128       --Gets a picture containing all the pixels in an
+ * --                             image whose color is within the lower/upper
+ * --                             128. The image to filter must be on the clipboard
+ * --                             (as a BITMAP).
+ * --
+ * III      mFilterDIB128       --As above, but the image must be a DIB.
+ * --
+ * III      mFilterBMPMakeGhostImage
+ * --                             Gets a picture which has all the pixels that don't
+ * --                             have the background color changed to a given color,
+ * --                             specified by the caller. The image to filter must be
+ * --                             on the clipboard (as a BITMAP).
+ * --
+ * III      mFilterDIBMakeGhostImage
+ * --                             As above, but the image must be a DIB.
+ * --
+ * I        mEmptyClipboard     --Empties the clipboard. This method MUST be called
+ * --                             after using the result of mFilterBMP and mFilterBMP128.
+ * --
+ * IIII     mFill               --Fills an area starting at a specified pixel
+ * --                             and defined by all the adjacent pixels with
+ * --                             the same color.
+ * --
+ * III      mGetColor           --Gets the color of a pixel on the stage. The
+ * --                             result is the index of the color in Director's
+ * --                             palette.
+ * --
+ * IIIIII   mDrawRect           -- Draws a rectangle of a specified color.
+ * --
+ * IIIIII   mDrawFrame          -- Draws a frame using a dotted pen.
+ */
 
 #include "director/director.h"
 #include "director/lingo/lingo.h"
diff --git a/engines/director/lingo/xlibs/ednox.cpp b/engines/director/lingo/xlibs/ednox.cpp
index 39abd7a5c45..b555c217b73 100644
--- a/engines/director/lingo/xlibs/ednox.cpp
+++ b/engines/director/lingo/xlibs/ednox.cpp
@@ -28,30 +28,31 @@
  * Return to Jurassic (Win)
  *
  *************************************/
+
 /*
--- Ednox External Factory. 22Nov93 PTM
-ednox
-I      mNew                --Creates a new instance of the XObject
-X      mDispose            --Disposes of XObject instance
-S      mName               --Returns the XObject name (Widget)
-I      mStatus             --Returns an integer status code
-SI     mError, code        --Returns an error string
-S      mLastError          --Returns last error string
-SSI    playSoundX       --Play an external sound, return status string
-S      clearSoundX      --Stop an external sound, return status string
-S      checkSoundX      --check an external sound,see if it is still playing
-SS      drawBkgndX,hBkgnd   --draw background image, from resource bitmap
-SS     SaveX, hStrIn    --Save string into a file(file name will be prompted
-SSSI    GetPathX,hSection,hStrIn,mMacMode, Retrieve the installed path name from the win.ini and return
-S      RestoreX     --Restore string from a file(file name will be prompted
-SS      SetDriveX,hStrIn    --Set the current path name
-SSS    IsCDX,hDrive,hStrIn --Check for the correct CD
-S      EnableTaskSwitch    --enable task switch
-S      DisableTaskSwitch   --Disable task switch
-SSS    getDocumentName,hdir,hext --Get strings of file in specific directory
-SSS    getDocumentFile,hDir,hFile --Get string from a file
-SSSS   saveDocumentFile,hDir,hFile,hStrIn --save string into a file
-SSS    deleteDocumentFile,hDir,hFile  -- delete a file from the directory
+ * -- Ednox External Factory. 22Nov93 PTM
+ * ednox
+ * I      mNew                --Creates a new instance of the XObject
+ * X      mDispose            --Disposes of XObject instance
+ * S      mName               --Returns the XObject name (Widget)
+ * I      mStatus             --Returns an integer status code
+ * SI     mError, code        --Returns an error string
+ * S      mLastError          --Returns last error string
+ * SSI    playSoundX       --Play an external sound, return status string
+ * S      clearSoundX      --Stop an external sound, return status string
+ * S      checkSoundX      --check an external sound,see if it is still playing
+ * SS      drawBkgndX,hBkgnd   --draw background image, from resource bitmap
+ * SS     SaveX, hStrIn    --Save string into a file(file name will be prompted
+ * SSSI    GetPathX,hSection,hStrIn,mMacMode, Retrieve the installed path name from the win.ini and return
+ * S      RestoreX     --Restore string from a file(file name will be prompted
+ * SS      SetDriveX,hStrIn    --Set the current path name
+ * SSS    IsCDX,hDrive,hStrIn --Check for the correct CD
+ * S      EnableTaskSwitch    --enable task switch
+ * S      DisableTaskSwitch   --Disable task switch
+ * SSS    getDocumentName,hdir,hext --Get strings of file in specific directory
+ * SSS    getDocumentFile,hDir,hFile --Get string from a file
+ * SSSS   saveDocumentFile,hDir,hFile,hStrIn --save string into a file
+ * SSS    deleteDocumentFile,hDir,hFile  -- delete a file from the directory
 */
 
 #include "director/director.h"
diff --git a/engines/director/lingo/xlibs/fedracul.cpp b/engines/director/lingo/xlibs/fedracul.cpp
index b0dc31798e9..d5ce705db86 100644
--- a/engines/director/lingo/xlibs/fedracul.cpp
+++ b/engines/director/lingo/xlibs/fedracul.cpp
@@ -25,6 +25,7 @@
 * Dracula's Secret
 *
 *************************************/
+
 /*
  * -- FEDracul External Factory.
  * FEDracul
@@ -42,12 +43,12 @@
  * I     mProgramStartup
  * II    mProgramShutdown
  */
+
 #include "director/director.h"
 #include "director/lingo/lingo.h"
 #include "director/lingo/lingo-object.h"
 #include "director/lingo/xlibs/fedracul.h"
 
-
 namespace Director {
 
 const char *FEDraculXObj::xlibName = "FEDracul";
diff --git a/engines/director/lingo/xlibs/feimasks.cpp b/engines/director/lingo/xlibs/feimasks.cpp
index e6117fb18a5..ba2c3e60638 100644
--- a/engines/director/lingo/xlibs/feimasks.cpp
+++ b/engines/director/lingo/xlibs/feimasks.cpp
@@ -25,6 +25,7 @@
 * Dracula's Secret
 *
 *************************************/
+
 /*
  * -- FEIMasks External Factory.
  * FEIMasks
@@ -33,6 +34,7 @@
  * S      mName               --Returns the XObject name (FEIMask)
  * III    mMaskID             -- h,v
  */
+
 #include "director/director.h"
 #include "director/lingo/lingo.h"
 #include "director/lingo/lingo-object.h"
diff --git a/engines/director/lingo/xlibs/feiprefs.cpp b/engines/director/lingo/xlibs/feiprefs.cpp
index a202c0e60ea..ea3f6949d2a 100644
--- a/engines/director/lingo/xlibs/feiprefs.cpp
+++ b/engines/director/lingo/xlibs/feiprefs.cpp
@@ -25,6 +25,7 @@
 * Dracula's Secret
 *
 *************************************/
+
 /*
  * -- FEIPrefs External Factory.
  * FEIPrefs
@@ -38,7 +39,6 @@
  * SSSS    mPrefReadString    -- Section,Entry,Default
  */
 
-
 #include "director/director.h"
 #include "director/lingo/lingo.h"
 #include "director/lingo/lingo-object.h"
diff --git a/engines/director/lingo/xlibs/fileexists.cpp b/engines/director/lingo/xlibs/fileexists.cpp
index 8a93e4ed6ff..07857b8b803 100644
--- a/engines/director/lingo/xlibs/fileexists.cpp
+++ b/engines/director/lingo/xlibs/fileexists.cpp
@@ -25,10 +25,11 @@
  * Yearn2Learn: The Flintstones Coloring Book
  *
  *************************************/
+
 /*
  * © 1989,1990 Apple Computer, Inc., v.1.1, by Anup Murarka
  * FileExists(pathname «, “noDialog”:errGlobal»)
-*/
+ */
 
 #include "director/director.h"
 #include "director/lingo/lingo.h"
diff --git a/engines/director/lingo/xlibs/findfolder.cpp b/engines/director/lingo/xlibs/findfolder.cpp
index 0bbdadf3307..d4794571c18 100644
--- a/engines/director/lingo/xlibs/findfolder.cpp
+++ b/engines/director/lingo/xlibs/findfolder.cpp
@@ -25,61 +25,62 @@
  * Yearn2Learn: The Flintstones Coloring Book
  *
  *************************************/
-/*
-                                             FindFolder 1.1
-
-                                        by Frédéric RINALDI
-
-
-DESCRIPTION
-------------
-  FindFolder returns the full pathname of the active System folder or any of its reserved folders (System 7.0).
-
-
-SYNTAX
--------
-                        FindFolder([<folder descriptor>[,<create it>]])
-
-PARAMETERS
-------------
-   <folder descriptor> is a string describing the folder. It must be one of these values (only first char is checked) :
-          A[pple menu]
-          C[ontrol Panel]
-          D[esktop]
-          E[xtensions]
-          F[onts] (System 7.1 only)
-          P[references]
-          M[onitor printing]
-          N[etwork trash]
-          T[rash]
-          I[tems startup]
-          S[ystem]
-          Y : TemporarY items
 
-   Default value is "S".
-
-   <create it> is a boolean telling if the XFCN must create the folder if not found (only with System 7.0). Default is FALSE.
-
-   Both parameters are optional. Using "!", "?" or "=" as first parameter will return an online help (resp. copyright,  syntax and output).
-
-USING
------
-  The XFCN returns the full pathname of the requested folder, ending with colon.
-   Under System 6.0, only current System folder can be returned.
-
-ERRORS
--------
-If an error occurs, the XFCN can return :
-     "Error : Empty parameter"
-     "Error : Second param must be boolean"
-     "Error : Folder not found"
-     "Error : Found file instead of folder"
-
-HISTORY
--------
-1.1 :                                                                                          04/21/92
-• Added "font" param for System 7.1
-*/
+/*
+ *                                              FindFolder 1.1
+ *
+ *                                         by Frédéric RINALDI
+ *
+ *
+ * DESCRIPTION
+ * ------------
+ *   FindFolder returns the full pathname of the active System folder or any of its reserved folders (System 7.0).
+ *
+ *
+ * SYNTAX
+ * -------
+ *                         FindFolder([<folder descriptor>[,<create it>]])
+ *
+ * PARAMETERS
+ * ------------
+ *    <folder descriptor> is a string describing the folder. It must be one of these values (only first char is checked) :
+ *           A[pple menu]
+ *           C[ontrol Panel]
+ *           D[esktop]
+ *           E[xtensions]
+ *           F[onts] (System 7.1 only)
+ *           P[references]
+ *           M[onitor printing]
+ *           N[etwork trash]
+ *           T[rash]
+ *           I[tems startup]
+ *           S[ystem]
+ *           Y : TemporarY items
+ *
+ *    Default value is "S".
+ *
+ *    <create it> is a boolean telling if the XFCN must create the folder if not found (only with System 7.0). Default is FALSE.
+ *
+ *    Both parameters are optional. Using "!", "?" or "=" as first parameter will return an online help (resp. copyright,  syntax and output).
+ *
+ * USING
+ * -----
+ *   The XFCN returns the full pathname of the requested folder, ending with colon.
+ *    Under System 6.0, only current System folder can be returned.
+ *
+ * ERRORS
+ * -------
+ * If an error occurs, the XFCN can return :
+ *      "Error : Empty parameter"
+ *      "Error : Second param must be boolean"
+ *      "Error : Folder not found"
+ *      "Error : Found file instead of folder"
+ *
+ * HISTORY
+ * -------
+ * 1.1 :                                                                                          04/21/92
+ * • Added "font" param for System 7.1
+ */
 
 #include "director/director.h"
 #include "director/lingo/lingo.h"
diff --git a/engines/director/lingo/xlibs/findsys.cpp b/engines/director/lingo/xlibs/findsys.cpp
index 1deeb51588a..3021e6e47a7 100644
--- a/engines/director/lingo/xlibs/findsys.cpp
+++ b/engines/director/lingo/xlibs/findsys.cpp
@@ -19,7 +19,14 @@
  *
  */
 
-/**
+/*************************************
+ *
+ * USED IN:
+ * teamxtreme2-win
+ *
+ *************************************/
+
+/*
  * Findsys
  * I      mNew                --Creates a new instance of the XObject
  * X      mDispose            --Disposes of XObject instance
@@ -29,8 +36,6 @@
  * --     string beginning with the word 'Error:<description>'
  * -- The Windows directory is where you should write Preferences files etc.
  * -- Mark_Carolan at aapda.com.au Compuserve 100242,1154
- *
- * USED IN: teamxtreme2-win
  */
 
 #include "director/director.h"
diff --git a/engines/director/lingo/xlibs/flushxobj.cpp b/engines/director/lingo/xlibs/flushxobj.cpp
index a0b87e73aea..c8031d8ee40 100644
--- a/engines/director/lingo/xlibs/flushxobj.cpp
+++ b/engines/director/lingo/xlibs/flushxobj.cpp
@@ -38,6 +38,26 @@
 #include "director/lingo/lingo-object.h"
 #include "director/lingo/xlibs/flushxobj.h"
 
+/*************************************
+ *
+ * USED IN:
+ * majestic-mac
+ *
+ *************************************/
+
+/*
+ *  8-- FlushEvents: an XObject to call toolbox FlushEvents().-- By Scott Kelley , sakelley at ucsd.edu, 6/2/93?-- Copyright
+ *  1993 The Regents of the University of California;-- Freely distributable. No warranties. Ask before selling!
+ * --5--  mNew creates a new instance of the Flush XObject. at --  Note that the object contains internal variables which allow>--  a unique masking operation to be built for each object, or:--  mFlushEvents can pass masks to FlushEvents() directly.
+ * I   mNew
+ * --?--  mFlushEvents is identical to the toolbox call FlushEvents()%XII mFlushEvents, eventMask, stopMask
+ * --?--  mClearMask clears the object's internal masks. Note that if<--  you never call this, the object starts with a default of9--  flushing everything (i.e. FlushEvent(everyEvent,0)  )
+ * X   mClearMask
+ * --<--  mAddToMask adds the specified event mask to the object's8--  internal masks (i.e. OR's it with the existing mask)!XII mAddToMask eventMask,stopMask
+ * --6--  mFlush calls FlushEvents() with the internal masks
+ * X   mFlush
+ * --"--  mDispose gets rid of an object2X   mDispose       -- dispose of an instance of u * s
+ */
 
 namespace Director {
 
diff --git a/engines/director/lingo/xlibs/fplayxobj.cpp b/engines/director/lingo/xlibs/fplayxobj.cpp
index 08aaf4fe7a9..91bbb4748fb 100644
--- a/engines/director/lingo/xlibs/fplayxobj.cpp
+++ b/engines/director/lingo/xlibs/fplayxobj.cpp
@@ -26,6 +26,10 @@
  *
  *************************************/
 
+/*
+ * ersion 2.0.3  Copyright © 1988-90 Farallon Computing, Inc.
+ */
+
 #include "director/director.h"
 #include "director/sound.h"
 #include "director/window.h"
@@ -123,4 +127,3 @@ void FPlayXObj::b_fsound(int nargs) {
 }
 
 } // End of namespace Director
-
diff --git a/engines/director/lingo/xlibs/jitdraw3.cpp b/engines/director/lingo/xlibs/jitdraw3.cpp
index 3368e5ee99e..4ea7867a7aa 100644
--- a/engines/director/lingo/xlibs/jitdraw3.cpp
+++ b/engines/director/lingo/xlibs/jitdraw3.cpp
@@ -26,34 +26,34 @@
  *
  *************************************/
 /*
-  -- JITDraw3 External Factory. 16Feb93 PTM
-  JITDraw3
-  I      mNew                --Creates a new instance of the XObject
-  X      mDispose            --Disposes of XObject instance
-  S      mName               --Returns the XObject name (JITDraw3)
-  I      mCheckRegistration
-  I      mCheckIfCDROM
-  S      mUserName
-  S      mUserCompany
-  IS      mSetSignature
-  S      mGetSignature
-  S      mPreRegister
-  II     mBookMark1
-  II     mBookMark2
-  II     mBookMark3
-  II     mBookMark4
-  II     mBookMark5
-  II     mBookMark6
-  I              mAddDrawButton
-  I              mRemoveDrawButton
-  I              mGotoDraw
-  I              mLoadDraw
-  I              mIsDrawLoaded
-  ISS    mMsgOkCancel
-  ISS    mMsgOk
-  ISS    mMsgYesNo
-  I    mOrder
-*/
+ * -- JITDraw3 External Factory. 16Feb93 PTM
+ * JITDraw3
+ * I      mNew                --Creates a new instance of the XObject
+ * X      mDispose            --Disposes of XObject instance
+ * S      mName               --Returns the XObject name (JITDraw3)
+ * I      mCheckRegistration
+ * I      mCheckIfCDROM
+ * S      mUserName
+ * S      mUserCompany
+ * IS      mSetSignature
+ * S      mGetSignature
+ * S      mPreRegister
+ * II     mBookMark1
+ * II     mBookMark2
+ * II     mBookMark3
+ * II     mBookMark4
+ * II     mBookMark5
+ * II     mBookMark6
+ * I              mAddDrawButton
+ * I              mRemoveDrawButton
+ * I              mGotoDraw
+ * I              mLoadDraw
+ * I              mIsDrawLoaded
+ * ISS    mMsgOkCancel
+ * ISS    mMsgOk
+ * ISS    mMsgYesNo
+ * I    mOrder
+ */
 
 #include "common/system.h"
 #include "common/translation.h"
diff --git a/engines/director/lingo/xlibs/labeldrvxobj.cpp b/engines/director/lingo/xlibs/labeldrvxobj.cpp
index f3f2cd8fe4b..fc6cbc35cc5 100644
--- a/engines/director/lingo/xlibs/labeldrvxobj.cpp
+++ b/engines/director/lingo/xlibs/labeldrvxobj.cpp
@@ -27,12 +27,12 @@
  *************************************/
 
 /*
-	-- LabelDrv XObject. Version 1.1 6/5/95 greg yachuk
-	LabelDrv
-	I      mNew          --Creates a new instance of the XObject
-	X      mDispose      --Disposes of XObject instance.
-	XSS    mSetRange     --Sets the drive letters to begin and end the search for the label. Default is C..Z.
-	SS     mGetDrive     --Return the drive letter where the specified label is mounted.
+ * -- LabelDrv XObject. Version 1.1 6/5/95 greg yachuk
+ * LabelDrv
+ * I      mNew          --Creates a new instance of the XObject
+ * X      mDispose      --Disposes of XObject instance.
+ * XSS    mSetRange     --Sets the drive letters to begin and end the search for the label. Default is C..Z.
+ * SS     mGetDrive     --Return the drive letter where the specified label is mounted.
 */
 
 #include "director/director.h"
diff --git a/engines/director/lingo/xlibs/memoryxobj.cpp b/engines/director/lingo/xlibs/memoryxobj.cpp
index 5db6ada5d8d..3c63fd7bb35 100644
--- a/engines/director/lingo/xlibs/memoryxobj.cpp
+++ b/engines/director/lingo/xlibs/memoryxobj.cpp
@@ -19,35 +19,41 @@
  *
  */
 
-/* Memory is a Mac only XObject.
+/*************************************
+ *
+ * USED IN:
+ * Chop Suey (win)
+ *
+ *************************************/
+
+/*
+ * Memory is a Mac only XObject.
  *
  * Implemented as a no-op, since ScummVM doesn't need to handle memory clears.
  *
  *
-	-- Memory XObject
-	-- December 18th, 1992
-	-- Written by Scott Kildall
-	-- 1992 by Macromedia, Inc
-	-- All rights reserved
-	--
-	I mNew
-	X mClear
-	X mCompact
-	X mPurge
-	I mAvailBytes
-	I mAvailBlock
-	I mStackSpace
-	I mGetVM
-	I mGetAddressing
-	I mGetCache
-	XI mSetCache
-	I mGetPhysicalRAM
-	I mGetMMU
-	I mGetLogicalPage
-	I mGetLogicalRAM
-	I mGetLowMemory
-
-	USED BY: Chop Suey (win)
+ * -- Memory XObject
+ * -- December 18th, 1992
+ * -- Written by Scott Kildall
+ * -- 1992 by Macromedia, Inc
+ * -- All rights reserved
+ * --
+ * I mNew
+ * X mClear
+ * X mCompact
+ * X mPurge
+ * I mAvailBytes
+ * I mAvailBlock
+ * I mStackSpace
+ * I mGetVM
+ * I mGetAddressing
+ * I mGetCache
+ * XI mSetCache
+ * I mGetPhysicalRAM
+ * I mGetMMU
+ * I mGetLogicalPage
+ * I mGetLogicalRAM
+ * I mGetLowMemory
  */
 
 #include "director/director.h"
diff --git a/engines/director/lingo/xlibs/miscx.cpp b/engines/director/lingo/xlibs/miscx.cpp
index 15b6a248c9f..137c70496b8 100644
--- a/engines/director/lingo/xlibs/miscx.cpp
+++ b/engines/director/lingo/xlibs/miscx.cpp
@@ -26,7 +26,9 @@
  * AMBER: Journeys Beyond
  *
  *************************************/
-/* -- Misc_X, Misc Utilities XObject v2.0
+
+/*
+ * -- Misc_X, Misc Utilities XObject v2.0
  * Misc_X
  * I      mNew
  * X      mDispose
diff --git a/engines/director/lingo/xlibs/moovxobj.cpp b/engines/director/lingo/xlibs/moovxobj.cpp
index d134289a6f9..45e9e9155d7 100644
--- a/engines/director/lingo/xlibs/moovxobj.cpp
+++ b/engines/director/lingo/xlibs/moovxobj.cpp
@@ -27,22 +27,22 @@
  *************************************/
 
 /*
-  moovXobj: Creative Multimedia, 1993 <<gzr>>
-  --moovXobj 10.22.93 <<gzr>>
-  moovXobj
-  I       mNew                            --Creates a new instance of the XObject.
-  X       mDispose                        --Disposes of XObject instance.
-  S       mName                           --Returns the XObject name (moovobj).
-  I       mMovieInit                      --Initialize QTW.
-  I       mMovieKill                      --Dispose of QTW.
-  I       mFondler                        --Movie idle task.
-  ISII    mPlayMovie name,left,top        --Play movie at designated location.
-  I       mPauseMovie                     --Pause active movie.
-  II      mSoundMovie                     --Turn movie sound on or off.
-  I       mStopMovie                      --Stops active movie.
-  I       mMovieDone                      --Returns true if movie done.
-
-  ScummVM Note: mMovieDone returns true when the movie is _not_ done.
+ * moovXobj: Creative Multimedia, 1993 <<gzr>>
+ * --moovXobj 10.22.93 <<gzr>>
+ * moovXobj
+ * I       mNew                            --Creates a new instance of the XObject.
+ * X       mDispose                        --Disposes of XObject instance.
+ * S       mName                           --Returns the XObject name (moovobj).
+ * I       mMovieInit                      --Initialize QTW.
+ * I       mMovieKill                      --Dispose of QTW.
+ * I       mFondler                        --Movie idle task.
+ * ISII    mPlayMovie name,left,top        --Play movie at designated location.
+ * I       mPauseMovie                     --Pause active movie.
+ * II      mSoundMovie                     --Turn movie sound on or off.
+ * I       mStopMovie                      --Stops active movie.
+ * I       mMovieDone                      --Returns true if movie done.
+ *
+ * ScummVM Note: mMovieDone returns true when the movie is _not_ done.
  */
 
 #include "video/qt_decoder.h"
diff --git a/engines/director/lingo/xlibs/movemousexobj.cpp b/engines/director/lingo/xlibs/movemousexobj.cpp
index f9cdf257a0d..adf3da2f5c7 100644
--- a/engines/director/lingo/xlibs/movemousexobj.cpp
+++ b/engines/director/lingo/xlibs/movemousexobj.cpp
@@ -26,9 +26,19 @@
 #include "director/lingo/lingo-object.h"
 #include "director/lingo/xlibs/movemousexobj.h"
 
-namespace Director {
+/*************************************
+ *
+ * USED IN:
+ * MediaBook Sampler CD/XObject Studio
+ *
+ *************************************/
 
-// MoveMouse 0.1 - (c) Andrew Green 1993 for Mac
+/*
+ * MoveMouse 0.1 - (c) Andrew Green 1993 for Mac
+ */
+
+
+namespace Director {
 
 const char *MoveMouseXObj::xlibName = "MoveMouse";
 const char *MoveMouseXObj::fileNames[] = {
diff --git a/engines/director/lingo/xlibs/orthoplayxobj.cpp b/engines/director/lingo/xlibs/orthoplayxobj.cpp
index 9a9738ad3cf..3e2ef4e135b 100644
--- a/engines/director/lingo/xlibs/orthoplayxobj.cpp
+++ b/engines/director/lingo/xlibs/orthoplayxobj.cpp
@@ -19,6 +19,13 @@
  *
  */
 
+/*************************************
+ *
+ * USED IN:
+ * Standard Macromedia XObject
+ *
+ *************************************/
+
 /*
  * Macromedia provides several XObjects for controlling some common devices that
  * play video and audio source material:
diff --git a/engines/director/lingo/xlibs/palxobj.cpp b/engines/director/lingo/xlibs/palxobj.cpp
index bd6a0fd4b78..325cc2b2005 100644
--- a/engines/director/lingo/xlibs/palxobj.cpp
+++ b/engines/director/lingo/xlibs/palxobj.cpp
@@ -19,7 +19,15 @@
  *
  */
 
-/* Quicktime movies and PICT castmembers continually display
+/*************************************
+ *
+ * USED IN:
+ * Majestic-mac
+ *
+ *************************************/
+
+/*
+ * Quicktime movies and PICT castmembers continually display
  * in wrong colors after an 8 palette switch
  * this XObject can be used to patch this problem
  * use mPatchIt message on the same frame as the palette switch
diff --git a/engines/director/lingo/xlibs/popupmenuxobj.cpp b/engines/director/lingo/xlibs/popupmenuxobj.cpp
index 8ad1747404f..0e975281b4b 100644
--- a/engines/director/lingo/xlibs/popupmenuxobj.cpp
+++ b/engines/director/lingo/xlibs/popupmenuxobj.cpp
@@ -19,80 +19,87 @@
  *
  */
 
+/*************************************
+ *
+ * USED IN:
+ * The Apartment
+ *
+ *************************************/
+
 /*
-  --PopMenu, Tool, 1.0, 4/1/90
-  --© 1989, 1990 MacroMind, Inc.
-  -- by Jeff Tanner
-  ------------------------------------------------
-  ------------------------------------------------
-  --  IMPORTANT NOTE:  In Lingo, build PopMenus after using
-  --    the command installMenu.  On the Mac, Pop-up menus are
-  --    extensions of the menu bar.  When the command installMenu
-  --    is called, this will remove all menus currently on
-  --    the menubar (including pop-up menus) and only install those
-  --    menus defined in the text window referenced by the
-  --    castNum parameter.  If installMenu is used after
-  --    creating PopMenus, these PopMenus must be disposed of
-  --    and then recreated.
-  ------------------------------------------------
-  --  MENULIST NOTE: In Lingo, there are several ways
-  --      to build the menu list for a PopUp menu.
-  --
-  --      - a menulist can be a continuous string
-  --          with items seperated by semicolons.
-  --          example: "item1;item2;item3"
-  --
-  --      - a menulist can be a set of strings, each
-  --          representing an item, separated by
-  --          &return& and ending with &return
-  --          example: "item1"&return&"item2"&return
-  --
-  --      - a menulist could come from a cast member with
-  --          each menu item separated by a carrage return.
-  --          example: set menulist to the text of cast A31
-  ------------------------------------------------
-  --  MENUITEM NOTE: Use only alphanumeric characters,
-  --      0 - 9 and A - Z.  Avoid dashes.  Indicate
-  --      style by "item1;item2<B;item3<U"
-  --      To change an item's style, add < followed by a
-  --      character at the end of the menu item text:
-  --          <B  Bold
-  --          <U  Underlined
-  --          <I  Italics
-  --          <S  Shadowed
-  --          <O  Outlined
-  ------------------------------------------------
-  ------------------------------------------------
-  --=METHODS=--
-  XSI     mNew, menuList, menuID --Creates a new instance of the XObject.
-  --   menuItemList - "item1;item2<B;item3<U"
-  --      Separate all items with semicolons.
-  --      Maximum character length of menulist is 256.
-  --   menuID - to avoid resourse conflict with Director,
-  --      use a menu ID between 100 and 1000.
-  --
-  X   mDispose --Disposes of the XObject instance.
-  S   mName --Returns the name of the XObject.
-  ------------------------------------------------
-  ------------------------------------------------
-  XS  mAppendMenu, menuList --Adds items to menuList.
-  XI  mDisableItem, itemNum --Disables item in pop up menu.
-  XI  mEnableItem, itemNum --Enables item in pop up menu.
-  SI  mGetItem, itemNum --Returns item in pop up menu.
-  I   mGetMenuID --Returns the assigned Menu ID number.
-  ------------------------------------------------
-  ------------------------------------------------
-  IIII    mPopNum, Left, Top, itemNum --Returns selected item's number.
-  SIII    mPopText, Left, Top, itemNum --Returns selected item's text.
-  ------------------------------------------------
-  ------------------------------------------------
-  XIS mSetItem, itemNum, newItemText --Sets changes to an item in pop up menu
-  XI  mSetItemMark, markNum --Sets marker for pop up menu: default is check.
-  XI  mSmart, TrueOrFalse --Remembers last selection if itemNum is 0
-  XII mSetItemIcon, itemNum, iconID --Attaches an icon to menu item, id# 257 - 511
-  ------------------------------------------------
-  ------------------------------------------------
-*/
+ * --PopMenu, Tool, 1.0, 4/1/90
+ * --© 1989, 1990 MacroMind, Inc.
+ * -- by Jeff Tanner
+ * ------------------------------------------------
+ * ------------------------------------------------
+ * --  IMPORTANT NOTE:  In Lingo, build PopMenus after using
+ * --    the command installMenu.  On the Mac, Pop-up menus are
+ * --    extensions of the menu bar.  When the command installMenu
+ * --    is called, this will remove all menus currently on
+ * --    the menubar (including pop-up menus) and only install those
+ * --    menus defined in the text window referenced by the
+ * --    castNum parameter.  If installMenu is used after
+ * --    creating PopMenus, these PopMenus must be disposed of
+ * --    and then recreated.
+ * ------------------------------------------------
+ * --  MENULIST NOTE: In Lingo, there are several ways
+ * --      to build the menu list for a PopUp menu.
+ * --
+ * --      - a menulist can be a continuous string
+ * --          with items seperated by semicolons.
+ * --          example: "item1;item2;item3"
+ * --
+ * --      - a menulist can be a set of strings, each
+ * --          representing an item, separated by
+ * --          &return& and ending with &return
+ * --          example: "item1"&return&"item2"&return
+ * --
+ * --      - a menulist could come from a cast member with
+ * --          each menu item separated by a carrage return.
+ * --          example: set menulist to the text of cast A31
+ * ------------------------------------------------
+ * --  MENUITEM NOTE: Use only alphanumeric characters,
+ * --      0 - 9 and A - Z.  Avoid dashes.  Indicate
+ * --      style by "item1;item2<B;item3<U"
+ * --      To change an item's style, add < followed by a
+ * --      character at the end of the menu item text:
+ * --          <B  Bold
+ * --          <U  Underlined
+ * --          <I  Italics
+ * --          <S  Shadowed
+ * --          <O  Outlined
+ * ------------------------------------------------
+ * ------------------------------------------------
+ * --=METHODS=--
+ * XSI     mNew, menuList, menuID --Creates a new instance of the XObject.
+ * --   menuItemList - "item1;item2<B;item3<U"
+ * --      Separate all items with semicolons.
+ * --      Maximum character length of menulist is 256.
+ * --   menuID - to avoid resourse conflict with Director,
+ * --      use a menu ID between 100 and 1000.
+ * --
+ * X   mDispose --Disposes of the XObject instance.
+ * S   mName --Returns the name of the XObject.
+ * ------------------------------------------------
+ * ------------------------------------------------
+ * XS  mAppendMenu, menuList --Adds items to menuList.
+ * XI  mDisableItem, itemNum --Disables item in pop up menu.
+ * XI  mEnableItem, itemNum --Enables item in pop up menu.
+ * SI  mGetItem, itemNum --Returns item in pop up menu.
+ * I   mGetMenuID --Returns the assigned Menu ID number.
+ * ------------------------------------------------
+ * ------------------------------------------------
+ * IIII    mPopNum, Left, Top, itemNum --Returns selected item's number.
+ * SIII    mPopText, Left, Top, itemNum --Returns selected item's text.
+ * ------------------------------------------------
+ * ------------------------------------------------
+ * XIS mSetItem, itemNum, newItemText --Sets changes to an item in pop up menu
+ * XI  mSetItemMark, markNum --Sets marker for pop up menu: default is check.
+ * XI  mSmart, TrueOrFalse --Remembers last selection if itemNum is 0
+ * XII mSetItemIcon, itemNum, iconID --Attaches an icon to menu item, id# 257 - 511
+ * ------------------------------------------------
+ * ------------------------------------------------
+ */
 
 #include "director/director.h"
 #include "director/lingo/lingo.h"
diff --git a/engines/director/lingo/xlibs/qtmovie.cpp b/engines/director/lingo/xlibs/qtmovie.cpp
index 49964ff6e29..19bf4e9e2b8 100644
--- a/engines/director/lingo/xlibs/qtmovie.cpp
+++ b/engines/director/lingo/xlibs/qtmovie.cpp
@@ -25,9 +25,10 @@
  * L-Zone (Mac II)
  *
  *************************************/
+
 /*
-  QTMovie OpenMovie, windowType, fileName, location, options...
-*/
+ * QTMovie OpenMovie, windowType, fileName, location, options...
+ */
 
 #include "director/director.h"
 #include "director/lingo/lingo.h"
diff --git a/engines/director/lingo/xlibs/registercomponent.cpp b/engines/director/lingo/xlibs/registercomponent.cpp
index e63395441a3..4a2353f3d8b 100644
--- a/engines/director/lingo/xlibs/registercomponent.cpp
+++ b/engines/director/lingo/xlibs/registercomponent.cpp
@@ -22,6 +22,13 @@
 #include "director/lingo/lingo.h"
 #include "director/lingo/xlibs/registercomponent.h"
 
+/*************************************
+ *
+ * USED IN:
+ *
+ * Star Trek: The Next Generation Interactive Technical Manual
+ *************************************/
+
 namespace Director {
 
 const char *RegisterComponent::xlibName = "RegisterComponent";
diff --git a/engines/director/lingo/xlibs/serialportxobj.cpp b/engines/director/lingo/xlibs/serialportxobj.cpp
index 1c055a53cf3..e7ad7d2c542 100644
--- a/engines/director/lingo/xlibs/serialportxobj.cpp
+++ b/engines/director/lingo/xlibs/serialportxobj.cpp
@@ -19,6 +19,13 @@
  *
  */
 
+/*************************************
+ *
+ * USED IN:
+ * Standard Macromedia Director XObject
+ *
+ *************************************/
+
 /*
  * Use the SerialPort XObject to send and receive data over the Macintosh’s
  * two standard serial ports (commonly called the modem and printer ports).
diff --git a/engines/director/lingo/xlibs/soundjam.cpp b/engines/director/lingo/xlibs/soundjam.cpp
index 96cd4b435d8..7cf8c1c7508 100644
--- a/engines/director/lingo/xlibs/soundjam.cpp
+++ b/engines/director/lingo/xlibs/soundjam.cpp
@@ -27,21 +27,21 @@
  *************************************/
 
 /*
-	-- SoundJam Copyright © Canter Technology 1995
-	SoundJam
-	II   mNew, numberOfChannels
-	ISI  mDefineFileSound, fullPathName, numberOfBeats
-	III  mDefineCastSound, castMemberNumber, numberOfBeats
-	II   mUndefineSound, soundID
-	III  mReadSome, soundID, byteCount
-	II   mStartSound, soundID
-	II   mSwitchNew, soundID
-	II   mSwitchParallel, soundID
-	I    mHasSwitchHappened
-	X    mToggleMute
-	X    mStop
-	X    mDispose
-*/
+ * -- SoundJam Copyright © Canter Technology 1995
+ * SoundJam
+ * II   mNew, numberOfChannels
+ * ISI  mDefineFileSound, fullPathName, numberOfBeats
+ * III  mDefineCastSound, castMemberNumber, numberOfBeats
+ * II   mUndefineSound, soundID
+ * III  mReadSome, soundID, byteCount
+ * II   mStartSound, soundID
+ * II   mSwitchNew, soundID
+ * II   mSwitchParallel, soundID
+ * I    mHasSwitchHappened
+ * X    mToggleMute
+ * X    mStop
+ * X    mDispose
+ */
 
 #include "director/director.h"
 #include "director/window.h"
@@ -199,4 +199,3 @@ void SoundJam::m_stop(int nargs) {
 }
 
 } // End of namespace Director
-
diff --git a/engines/director/lingo/xlibs/spacemgr.cpp b/engines/director/lingo/xlibs/spacemgr.cpp
index b861eddf7b9..c149511ee58 100644
--- a/engines/director/lingo/xlibs/spacemgr.cpp
+++ b/engines/director/lingo/xlibs/spacemgr.cpp
@@ -19,6 +19,57 @@
  *
  */
 
+/**************************************************
+ *
+ * USED IN:
+ * DEVO Presents: Adventures of the Smart Patrol
+ *
+ **************************************************/
+
+/*
+ * -- SpaceMgr XObject. Copyright 1995 Inscape v1.0b1 10March95 BDL
+ * SpaceMgr
+ * I      mNew                                                                --Creates a new instance
+ * X      mDispose                                                            --Disposes XObject instance
+ * I                  mLastError                                                                                      --Last error code
+ * I                  mMemUsed                                                                                                --RAM occupied by this object and data
+ * S                  mListData                                                                                               --List all data
+ * I      mSortAll                                                            --Sort internal arrays
+ * IS     mCheckForDups, bool                 --Set to true to check for Duplicate items before adding an element
+ * IS     mParseText, text                            --Parse Text into a space structure
+ * S                  mGetCurData                                                                                     --List Current data
+ * ISSSS      mSetCurData, sc, s, n, v                                --pass in names of elements to make current
+ * ISS                mAddSpaceCollection, name, data --Add a Space Collection
+ * IS                 mRemoveSpaceCollection, name            --Remove a Space Collection
+ * IS                 mSetCurSpaceCollection, name            --Set current SpaceCollection
+ * S                  mGetCurSpaceCollection                                  --Get current SpaceCollection
+ * SS                 mGetSpaceCollection, name                               --Get SpaceCollection with name
+ * ISS                mAddSpace, name, data                                           --Add a Space
+ * IS                 mRemoveSpace, name                                                      --Remove a Space
+ * IS                 mSetCurSpace, name                                                      --Set current Space
+ * S                  mGetCurSpace                                                                            --Get current Space
+ * SS                 mGetSpace, name                                                                 --Get Space with name
+ * ISS                mAddNode, name, data                                            --Add a Node
+ * IS                 mRemoveNode, name                                                               --Remove a Node
+ * IS                 mSetCurNode, name                                                               --Set current Node
+ * S                  mGetCurNode                                                                                     --Get current Node
+ * SS                 mGetNode, name                                                                  --Get Node with name
+ * ISS                mAddView, name, data                                            --Add a View
+ * IS                 mRemoveView, name                                                               --Remove a View
+ * IS                 mSetCurView, name                                                               --Set current View
+ * S                  mGetCurView                                                                                     --Get current View
+ * SS                 mGetView, name                                                                  --Get View with name
+ * ISS                mAddLocalLink, name, data                               --Add a link to the current view
+ * IS                 mRemoveLocalLink, name                                  --Remove a link from the current View
+ * I                  mRemoveLocalLinks                                                               --Remove all links from the current View
+ * SS                 mGetLocalLink, name                                                     --Get link with name from the current view
+ * S                  mGetLocalLinks                                                                  --Get all links from the current view
+ * ISS                mAddGlobalLink, name, data                      --Add a global link
+ * IS                 mRemoveGlobalLink, name                                 --Remove a global link
+ * SS                 mGetGlobalLink, name                                            --Get global link with name
+ * S                  mGetGlobalLinks                                                                 --Get list of all global links
+ */
+
 #include "common/system.h"
 #include "common/tokenizer.h"
 
@@ -30,56 +81,6 @@
 
 namespace Director {
 
-/**************************************************
- *
- * USED IN:
- * DEVO Presents: Adventures of the Smart Patrol
- *
- **************************************************/
-/*
--- SpaceMgr XObject. Copyright 1995 Inscape v1.0b1 10March95 BDL
-SpaceMgr
-I      mNew                                                                --Creates a new instance
-X      mDispose                                                            --Disposes XObject instance
-I                  mLastError                                                                                      --Last error code
-I                  mMemUsed                                                                                                --RAM occupied by this object and data
-S                  mListData                                                                                               --List all data
-I      mSortAll                                                            --Sort internal arrays
-IS     mCheckForDups, bool                 --Set to true to check for Duplicate items before adding an element
-IS     mParseText, text                            --Parse Text into a space structure
-S                  mGetCurData                                                                                     --List Current data
-ISSSS      mSetCurData, sc, s, n, v                                --pass in names of elements to make current
-ISS                mAddSpaceCollection, name, data --Add a Space Collection
-IS                 mRemoveSpaceCollection, name            --Remove a Space Collection
-IS                 mSetCurSpaceCollection, name            --Set current SpaceCollection
-S                  mGetCurSpaceCollection                                  --Get current SpaceCollection
-SS                 mGetSpaceCollection, name                               --Get SpaceCollection with name
-ISS                mAddSpace, name, data                                           --Add a Space
-IS                 mRemoveSpace, name                                                      --Remove a Space
-IS                 mSetCurSpace, name                                                      --Set current Space
-S                  mGetCurSpace                                                                            --Get current Space
-SS                 mGetSpace, name                                                                 --Get Space with name
-ISS                mAddNode, name, data                                            --Add a Node
-IS                 mRemoveNode, name                                                               --Remove a Node
-IS                 mSetCurNode, name                                                               --Set current Node
-S                  mGetCurNode                                                                                     --Get current Node
-SS                 mGetNode, name                                                                  --Get Node with name
-ISS                mAddView, name, data                                            --Add a View
-IS                 mRemoveView, name                                                               --Remove a View
-IS                 mSetCurView, name                                                               --Set current View
-S                  mGetCurView                                                                                     --Get current View
-SS                 mGetView, name                                                                  --Get View with name
-ISS                mAddLocalLink, name, data                               --Add a link to the current view
-IS                 mRemoveLocalLink, name                                  --Remove a link from the current View
-I                  mRemoveLocalLinks                                                               --Remove all links from the current View
-SS                 mGetLocalLink, name                                                     --Get link with name from the current view
-S                  mGetLocalLinks                                                                  --Get all links from the current view
-ISS                mAddGlobalLink, name, data                      --Add a global link
-IS                 mRemoveGlobalLink, name                                 --Remove a global link
-SS                 mGetGlobalLink, name                                            --Get global link with name
-S                  mGetGlobalLinks                                                                 --Get list of all global links
-*/
-
 const char *SpaceMgr::xlibName = "SpaceMgr";
 const char *SpaceMgr::fileNames[] = {
 	"SpaceMgr",
diff --git a/engines/director/lingo/xlibs/videodiscxobj.cpp b/engines/director/lingo/xlibs/videodiscxobj.cpp
index 73d996b816e..7b838792e9b 100644
--- a/engines/director/lingo/xlibs/videodiscxobj.cpp
+++ b/engines/director/lingo/xlibs/videodiscxobj.cpp
@@ -19,6 +19,13 @@
  *
  */
 
+/*************************************
+ *
+ * USED IN:
+ * Standard Macromedia Director XObject
+ *
+ *************************************/
+
 /*
  * mNew, portObject, baudRate, playerType  creates a
  *    new instance and returns error code
diff --git a/engines/director/lingo/xlibs/volumelist.cpp b/engines/director/lingo/xlibs/volumelist.cpp
index 36a4ecc82ba..a91b9cf255b 100644
--- a/engines/director/lingo/xlibs/volumelist.cpp
+++ b/engines/director/lingo/xlibs/volumelist.cpp
@@ -25,10 +25,11 @@
  * Yearn2Learn: The Flintstones Coloring Book
  *
  *************************************/
+
 /*
  * v1.0, ©1989, 1990 Eric Carlson, Apple Computer, Inc.
  * VolumeList(«“nodialog:ErrMsg”»)
-*/
+ */
 
 #include "director/director.h"
 #include "director/lingo/lingo.h"
diff --git a/engines/director/lingo/xlibs/widgetxobj.cpp b/engines/director/lingo/xlibs/widgetxobj.cpp
index 786790107ec..13d5a4c4db0 100644
--- a/engines/director/lingo/xlibs/widgetxobj.cpp
+++ b/engines/director/lingo/xlibs/widgetxobj.cpp
@@ -19,16 +19,21 @@
  *
  */
 
+/*************************************
+ *
+ * USED IN:
+ * Alice: An Interactive Museum
+ *
+ *************************************/
+
 /*
  * Widget External Factory
- * Used in: "Alice: An Interactive Museum"
  *
  * Widget
  * I      mNew                --Creates a new instance of the XObject
  * X      mDispose            --Disposes of XObject instance
  * S      mGetPro             --
  * I      mAskQuit            --
- *
  */
 
 #include "director/director.h"
diff --git a/engines/director/lingo/xlibs/winxobj.cpp b/engines/director/lingo/xlibs/winxobj.cpp
index 4f1aa52845e..f66ad50fe93 100644
--- a/engines/director/lingo/xlibs/winxobj.cpp
+++ b/engines/director/lingo/xlibs/winxobj.cpp
@@ -19,14 +19,21 @@
  *
  */
 
-/* RearWindow is a Mac only XObject. Its purpose is to cover the screen
+/*************************************
+ *
+ * USED IN:
+ * Alice: An Interactive Museum
+ *
+ *************************************/
+
+/*
+ * RearWindow is a Mac only XObject. Its purpose is to cover the screen
  * with either a 1-bit pattern, indexed color, direct(RGB) color, bitmappedCastMember
  * or PICT file picture.
  *
  * It does this when the Stage size is smaller than the monitor screen.
  *
  * Implemented as a no-op, since ScummVM doesn't handle desktop backgrounds.
- *
  */
 
 #include "director/director.h"
diff --git a/engines/director/lingo/xlibs/xio.cpp b/engines/director/lingo/xlibs/xio.cpp
index 7767eeda9ff..e19d5dcd960 100644
--- a/engines/director/lingo/xlibs/xio.cpp
+++ b/engines/director/lingo/xlibs/xio.cpp
@@ -25,14 +25,16 @@
  * מיץ פטל (Mitz Petel)
  *
  *************************************/
-/* -- Xio - Functions for file manipulation 10Aug96 Moty Aharobnovitz
-xio
-I	mNew			--Creates a new instance of the XObject
-X	mDispose		--Disposes of XObject instance
-IS  mUnlock    --Given a correct code, enables usage of the Xobject
-IS  mDeleteFile  --Removes a file from the file system
-ISS  mCopyFile   --Copies a file from source to dest
-*/
+
+/*
+ * -- Xio - Functions for file manipulation 10Aug96 Moty Aharobnovitz
+ * xio
+ * I	mNew			--Creates a new instance of the XObject
+ * X	mDispose		--Disposes of XObject instance
+ * IS  mUnlock    --Given a correct code, enables usage of the Xobject
+ * IS  mDeleteFile  --Removes a file from the file system
+ * ISS  mCopyFile   --Copies a file from source to dest
+ */
 
 #include "director/director.h"
 #include "director/lingo/lingo.h"
diff --git a/engines/director/lingo/xlibs/xplayanim.cpp b/engines/director/lingo/xlibs/xplayanim.cpp
index 344fd609194..2c9fb8f0d3d 100644
--- a/engines/director/lingo/xlibs/xplayanim.cpp
+++ b/engines/director/lingo/xlibs/xplayanim.cpp
@@ -19,6 +19,13 @@
  *
  */
 
+/*************************************
+ *
+ * USED IN:
+ * Iron Helix
+ *
+ *************************************/
+
 #include "video/paco_decoder.h"
 
 #include "director/director.h"
diff --git a/engines/director/lingo/xlibs/yasix.cpp b/engines/director/lingo/xlibs/yasix.cpp
index 82442dda139..36541e5201c 100644
--- a/engines/director/lingo/xlibs/yasix.cpp
+++ b/engines/director/lingo/xlibs/yasix.cpp
@@ -25,7 +25,10 @@
  * Yearn2Learn: The Flintstones Coloring Book
  *
  *************************************/
-/* v0.2, ©1992 Clark Brady, 317/839-0442 - YASIX - Yet Another System Information XFCN */
+
+/*
+ * v0.2, ©1992 Clark Brady, 317/839-0442 - YASIX - Yet Another System Information XFCN
+ */
 
 #include "director/director.h"
 #include "director/lingo/lingo.h"




More information about the Scummvm-git-logs mailing list