Skip to content

Commit 31960aa

Browse files
committed
Update page on source dates
Signed-off-by: worksofliam <mrliamallan@live.co.uk>
1 parent 2e72e33 commit 31960aa

File tree

2 files changed

+14
-14
lines changed

2 files changed

+14
-14
lines changed

src/assets/srcseq_view.png

1.3 MB
Loading

src/content/docs/developing/sourcedates.mdx

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -7,37 +7,29 @@ import { CardGrid, Card, Icon, Aside } from '@astrojs/starlight/components';
77
Source dates are supported in Code for IBM i, but not by default.
88

99
## Prerequisites to using source dates
10+
1011
For source dates to be enabled, the QCCSID system value must not be 65535. See [our documentation about encoding](../../tips/ccsid/) and [IBM's documentation about the QCCSID system value](https://www.ibm.com/docs/en/i/7.5?topic=faqs-i-system-value-qccsid)<Icon name="external" color="cyan" class="icon-inline" />.
1112

1213
## Source date settings
1314

1415
Source dates can be enabled in the connection settings.
1516

16-
There are three options pertaining to source dates:
17+
There are two options pertaining to source dates:
1718

1819
* *Enable Source Dates*: If source date support is enabled for source members
19-
* *Source date tracking mode*: What type of mode should be used to track changes. More below.
2020
* *Source Dates in Gutter*: Whether the source dates should appear in the gutter of the editor when enabled
2121

22-
## Tracking modes
23-
24-
There are two types of editing modes for source dates
25-
26-
* *Edit mode* which is the traditional style for editing. When a line changes, the source date of that line will be updated. It does not understand undo/redo. It is considered the 'dumb' mode.
27-
* *Diff mode* is the modern approach to source date tracking. Instead of tracking edits line by line, it is doing [a diff](https://en.wikipedia.org/wiki/Diff)<Icon name="external" color="cyan" class="icon-inline" /> to understand what has changed in the document. It diffs the base document (from last open or last save) against the latest dirty version of the document. This is a Test enhancement. It does understand undo/redo. It is considered the 'smarter' mode of the two modes.
28-
22+
## How dates are tracked
2923

30-
<Aside type="caution">
31-
As of Code for IBM i 2.15.0, the 'edit' tracking mode has been removed and only diff will be used. The documentation will be updated to reflect that change for 3.0.0.
32-
</Aside>
24+
*Diff mode* is the modern approach to source date tracking. Instead of tracking edits line by line, it is doing [a diff](https://en.wikipedia.org/wiki/Diff)<Icon name="external" color="cyan" class="icon-inline" /> to understand what has changed in the document. It diffs the base document (from last open or last save) against the latest dirty version of the document. This is a Test enhancement. It does understand undo/redo. It is considered the 'smarter' mode of the two modes.
3325

3426
## Source date filtering
3527

3628
<CardGrid>
3729

3830
<Card>
3931

40-
This feature is only enabled when using 'Diff mode' tracking, as well as having the source dates gutter enabled.
32+
This feature is only enabled when the source dates gutter is enabled.
4133

4234
Hovering over the gutter will show two buttons to:
4335

@@ -68,4 +60,12 @@ There is also a button on the status bar the user can use to start a new date fi
6860

6961
</Card></CardGrid>
7062

71-
---
63+
## Source sequence view
64+
65+
This feature is only enabled when the source dates gutter is enabled.
66+
67+
You are able to hover over the gutter to enable or disable the sequence view. This will show the `SRCSEQ` value of the source member in the gutter. The sequence view will revert back to the source date when the file is edited.
68+
69+
Source sequences are not retained. This means that when saving a member, Code for IBM i will resequence the source member.
70+
71+
![Source sequence view](../../../assets/srcseq_view.png)

0 commit comments

Comments
 (0)