-
Notifications
You must be signed in to change notification settings - Fork 9
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Updated with Tobias' submissions for SMSQ/E in various versions.
- Loading branch information
1 parent
4f85750
commit fa51bcb
Showing
29 changed files
with
849 additions
and
864 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,34 @@ | ||
.. _day-pct: | ||
|
||
DAY% | ||
==== | ||
|
||
+----------+-------------------------------------------------------------------+ | ||
| Syntax | DAY% [datestamp] | | ||
+----------+-------------------------------------------------------------------+ | ||
| Location | SMSQ/E | | ||
+----------+-------------------------------------------------------------------+ | ||
|
||
This function complements the :ref:`date` and :ref:`date-dlr` functions, by returning the day | ||
number corresponding to the given datestamp, or current date, if no datestamp | ||
was given. | ||
|
||
**Examples** | ||
|
||
:: | ||
|
||
PRINT DAY% (0) | ||
|
||
will print the day part of the QL's epoch, 1 for 1st of January | ||
|
||
:: | ||
|
||
PRINT DAY% | ||
|
||
will print the current day number. | ||
|
||
|
||
**CROSS-REFERENCE** | ||
|
||
See :ref:`date`, :ref:`year-pct`, :ref:`month-pct`. | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -14,6 +14,7 @@ Keywords D | |
date.rst | ||
date-dlr.rst | ||
day-dlr.rst | ||
day-pct.rst | ||
dbl.rst | ||
ddown.rst | ||
deallocate.rst | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,33 @@ | ||
.. _fet: | ||
|
||
FET | ||
=== | ||
|
||
+----------+-------------------------------------------------------------------+ | ||
| Syntax | FET(file :sup:`*`\ [,{filex | #chx}]\ :sup:`*` [;cmd$]) | | ||
+----------+-------------------------------------------------------------------+ | ||
| Location | SMSQ/E | | ||
+----------+-------------------------------------------------------------------+ | ||
|
||
Executes and returns the job ID of the job filename in suspended state (by | ||
immediately setting the new job's priority to zero). | ||
This function is a functional version of :ref:`et`, with the same set of arguments, | ||
that executes a job into suspended state for tracing with a monitor. In addition | ||
to what :ref:`et` does, it returns the job ID of the new job that was started. | ||
|
||
|
||
**Examples** | ||
|
||
:: | ||
|
||
jId = FEX ("win1_XChange_xchange") | ||
|
||
Will start Psion XChange in win1_xchange in suspended state and return the job | ||
ID of the new job. | ||
|
||
|
||
|
||
**CROSS-REFERENCE** | ||
|
||
See :ref:`et`, :ref:`exec`, :ref:`jobs`. | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,32 @@ | ||
.. _few: | ||
|
||
FEW | ||
=== | ||
|
||
+----------+-------------------------------------------------------------------+ | ||
| Syntax | FEW(filen :sup:`*`\ [,{filex | #chx}]\ :sup:`*` [;cmd$]) | | ||
+----------+-------------------------------------------------------------------+ | ||
| Location | SMSQ/E | | ||
+----------+-------------------------------------------------------------------+ | ||
|
||
Executes and waits for completion of the job filen, then returns the error code | ||
from that job. FEW is a function version of :ref:`ew` and shares its argument list. | ||
|
||
|
||
**Example** | ||
|
||
:: | ||
|
||
retcode = FEW ("win1_XChange_xchange") | ||
|
||
Will start Psion XChange in win1_xchange, wait until that job has ended and will | ||
then return the error code of that job. | ||
|
||
|
||
|
||
**CROSS-REFERENCE** | ||
|
||
See :ref:`ew`, | ||
:ref:`exec-w`, | ||
:ref:`jobs`. | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,34 @@ | ||
.. _fex-m: | ||
|
||
FEX\_M | ||
====== | ||
|
||
+----------+-----------------------------------------------------------------------------------+ | ||
| Syntax | FEX\_M file :sup:`\*`\ [,{file\ :sup:`x` \| #ch\ :sup:`x`\ }]\ :sup:`\*` [;cmd$] | | ||
+----------+-----------------------------------------------------------------------------------+ | ||
| Location | SMSQ/E | | ||
+----------+-----------------------------------------------------------------------------------+ | ||
|
||
Variant of the :ref:`fex` function that executes the given file and returns the new | ||
job ID. Differently to :ref:`fex`, which starts the new job as owned by the system, | ||
FEX\_M starts the job as a job owned by its parent job. This means that the | ||
newly started job will be killed whenever its owner job is killed. | ||
|
||
**Example** | ||
|
||
:: | ||
|
||
jobid = FEX\_M(win1_qmac) | ||
|
||
Will execute Qmac as a job owned by the current S*BASIC interpreter. When the | ||
current interpreter ceases to exist, the new Qmac job will also be killed. | ||
|
||
**NOTE** | ||
|
||
An exhaustive explanation of the possible options can be found with the | ||
description of :ref:`ex`. FEX\_M takes the exact same arguments. | ||
|
||
**CROSS-REFERENCE** | ||
|
||
See :ref:`ex`. | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,35 @@ | ||
.. _fex: | ||
|
||
FEX | ||
=== | ||
|
||
+----------+-------------------------------------------------------------------+ | ||
| Syntax | FEX(file :sup:`*`\ [,{filex | #chx}]\ :sup:`*` [;cmd$]) | | ||
+----------+-------------------------------------------------------------------+ | ||
| Location | SMSQ/E | | ||
+----------+-------------------------------------------------------------------+ | ||
|
||
Executes and returns the job ID of the job filename. | ||
This function is a functional version of :ref:`ex`, with the same set of arguments, | ||
that executes a job. In addition to what :ref:`ex` does, it returns the job ID of the | ||
new job that was started. | ||
|
||
**Example** | ||
|
||
:: | ||
|
||
jId = FEX ("win1_XChange_xchange") | ||
|
||
Will start Psion XChange in win1_xchange and return the job ID of the new job. | ||
|
||
**NOTES** | ||
In some combinations of SMSQ/E and FileInfo2 versions, there might be a clash of | ||
extension names between FEX supplied as an SMSQ/E function (as described here) | ||
and a function with the same name (but very different purpose) supplied by | ||
FileInfo2. Later versions of FileInfo2 resolved this name clash by renaming the | ||
corresponding function to EXF. | ||
|
||
**CROSS-REFERENCE** | ||
|
||
See :ref:`ex`, :ref:`fet`, :ref:`few`, :ref:`exec`, :ref:`jobs`. | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,29 @@ | ||
.. _hot_getstuff-dlr: | ||
|
||
HOT_GETSTUFF$ | ||
============= | ||
|
||
+----------+-------------------------------------------------------------------+ | ||
| Syntax | HOT_GETSTUFF$ [index] | | ||
+----------+-------------------------------------------------------------------+ | ||
| Location | SMSQ/E | | ||
+----------+-------------------------------------------------------------------+ | ||
|
||
This function returns the contents of the hotkey stuffer buffer. If given a | ||
parameter of 0, or no parameter, it will return the current contents of the | ||
stuffer buffer (like ALT-SPACE). A parameter of -1 gets the previous contents, | ||
like ALT-SHIFT-SPACE | ||
|
||
**Examples** | ||
|
||
:: | ||
|
||
result = HOT_GETSTUFF$ : REMark Return current contents of stuffer buffer | ||
result = HOT_GETSTUFF$(0) : REMark Return current contents of stuffer buffer | ||
result = HOT_GETSTUFF$(-1) : REMark Return previous contents of stuffer buffer | ||
|
||
|
||
**CROSS-REFERENCE** | ||
|
||
See :ref:`get_stuff-dlr`, :ref:`hot_stuff`. | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -7,6 +7,7 @@ Keywords J | |
|
||
jbase.rst | ||
jobcbs.rst | ||
jobid.rst | ||
jobs.rst | ||
job-dlr.rst | ||
job-name.rst | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,29 @@ | ||
.. _jobid: | ||
|
||
JOBID | ||
===== | ||
|
||
+----------+-------------------------------------------------------------------+ | ||
| Syntax | JOBID [({nr, tag} | <name>)] | | ||
+----------+-------------------------------------------------------------------+ | ||
| Location | SMSQ/E | | ||
+----------+-------------------------------------------------------------------+ | ||
|
||
This function returns the 32-bit job id of the job with the given details as a | ||
decimal value. The optional parameters may be either a job number and job tag | ||
(as displayed by the JOBS command), or the job name. If no parameters are | ||
supplied, the Job ID number of the current job is returned. | ||
|
||
**Examples** | ||
|
||
:: | ||
|
||
result = JOBID :REMark Returns the job ID of the current job | ||
result = JOBID(job_name$) :REMark Returns the job ID of the job specified in job_name$ | ||
result = JOBID$(nr, tag) :REMark Returns the job ID of the job specified by nr and tag | ||
|
||
|
||
**CROSS-REFERENCE** | ||
|
||
See :ref:`jobs`, :ref:`job-pct`. | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -53,6 +53,7 @@ Keywords M | |
mnet-use.rst | ||
mod.rst | ||
mode.rst | ||
month-pct.rst | ||
more.rst | ||
mouse-speed.rst | ||
mouse-stuff.rst | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,34 @@ | ||
.. _month-pct: | ||
|
||
MONTH% | ||
====== | ||
|
||
+----------+-------------------------------------------------------------------+ | ||
| Syntax | MONTH% [datestamp] | | ||
+----------+-------------------------------------------------------------------+ | ||
| Location | SMSQ/E | | ||
+----------+-------------------------------------------------------------------+ | ||
|
||
This function complements the :ref:`date` and :ref:`date-dlr` functions, by returning the month | ||
number corresponding to the given datestamp, or current date, if no datestamp | ||
was given. | ||
|
||
**Examples** | ||
|
||
:: | ||
|
||
PRINT MONTH% (0) | ||
|
||
will print the month part of the QL's epoch, 1 for January | ||
|
||
:: | ||
|
||
PRINT MONTH% | ||
|
||
will print the current month number, (1...12, starting with January). | ||
|
||
|
||
**CROSS-REFERENCE** | ||
|
||
See :ref:`date`, :ref:`year-pct`. | ||
|
Oops, something went wrong.