Skip to content

Commit 0eee5a1

Browse files
committed
Revise User's Guide
Update links to F Prime docs
1 parent 9c37f47 commit 0eee5a1

File tree

6 files changed

+68
-64
lines changed

6 files changed

+68
-64
lines changed

docs/fpp-spec.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10579,7 +10579,7 @@ <h3 id="Analysis-and-Translation_Translation-Tools">22.4. Translation Tools</h3>
1057910579
</div>
1058010580
<div id="footer">
1058110581
<div id="footer-text">
10582-
Last updated 2024-12-04 15:30:17 -0800
10582+
Last updated 2024-12-09 16:59:12 -0800
1058310583
</div>
1058410584
</div>
1058510585
<script src="code-prettify/run_prettify.js"></script>

docs/fpp-users-guide.html

Lines changed: 34 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -756,7 +756,7 @@ <h2 id="Introduction">1. Introduction</h2>
756756
SmallSat 2018</a>
757757
provides an overview of F Prime.
758758
For more detailed information about F Prime, see the
759-
<a href="https://github.com/nasa/fprime/blob/devel/docs/UsersGuide/guide.md">F Prime User&#8217;s Guide</a>.</p>
759+
<a href="https://fprime.jpl.nasa.gov/latest/documentation/user-manual/">F Prime User Manual</a>.</p>
760760
</div>
761761
<div class="paragraph">
762762
<p>The goals of FPP are as follows:</p>
@@ -3635,7 +3635,7 @@ <h3 id="Defining-State-Machines_Writing-a-State-Machine-Definition">9.1. Writing
36353635
of FPP state machines.
36363636
For more details about the C&#43;&#43; code generation
36373637
for state machines, see the
3638-
<a href="https://github.com/nasa/fprime/blob/devel/docs/Design/general.md">F Prime design
3638+
<a href="https://fprime.jpl.nasa.gov/latest/documentation/user-manual/">F Prime design
36393639
documentation</a>.</p>
36403640
</div>
36413641
</div>
@@ -5794,7 +5794,7 @@ <h4 id="Defining-Components_Port-Instances_Basic-Port-Instances">10.2.1. Basic P
57945794
base class with a virtual handler function, and then override that virtual
57955795
function in a derived class that you write.
57965796
For further details about implementing F Prime components, see the
5797-
<a href="https://github.com/nasa/fprime/blob/master/docs/UsersGuide/guide.md">F Prime User&#8217;s Guide</a>.</p>
5797+
<a href="https://fprime.jpl.nasa.gov/latest/documentation/user-manual/">F Prime User Manual</a>.</p>
57985798
</div>
57995799
<div class="paragraph">
58005800
<p><strong>Note on terminology:</strong> As explained above, there is a technical
@@ -6089,7 +6089,7 @@ <h4 id="Defining-Components_Port-Instances_Serial-Port-Instances">10.2.6. Serial
60896089
This flexibility comes at the cost that you lose the type
60906090
compile-time type checking provided by port connections with named types.
60916091
For more information about serial ports and their use, see
6092-
the <a href="https://github.com/nasa/fprime/blob/master/docs/UsersGuide/guide.md">F Prime User&#8217;s Guide</a>.</p>
6092+
the <a href="https://fprime.jpl.nasa.gov/latest/documentation/user-manual/">F Prime User Manual</a>.</p>
60936093
</div>
60946094
</div>
60956095
</div>
@@ -6228,7 +6228,7 @@ <h4 id="Defining-Components_Special-Port-Instances_Command-Ports">10.3.1. Comman
62286228
<div class="paragraph">
62296229
<p>For further information about command registration, receipt, and
62306230
response, and implementing command handlers, see the
6231-
<a href="https://github.com/nasa/fprime/blob/master/docs/UsersGuide/guide.md">F Prime User&#8217;s Guide</a>.</p>
6231+
<a href="https://fprime.jpl.nasa.gov/latest/documentation/user-manual/">F Prime User Manual</a>.</p>
62326232
</div>
62336233
</div>
62346234
<div class="sect3">
@@ -6309,7 +6309,7 @@ <h4 id="Defining-Components_Special-Port-Instances_Event-Ports">10.3.2. Event Po
63096309
</div>
63106310
<div class="paragraph">
63116311
<p>For further information about events in F Prime, see the
6312-
<a href="https://github.com/nasa/fprime/blob/master/docs/UsersGuide/guide.md">F Prime User&#8217;s Guide</a>.</p>
6312+
<a href="https://fprime.jpl.nasa.gov/latest/documentation/user-manual/">F Prime User Manual</a>.</p>
63136313
</div>
63146314
</div>
63156315
<div class="sect3">
@@ -6358,7 +6358,7 @@ <h4 id="Defining-Components_Special-Port-Instances_Telemetry-Ports">10.3.3. Tele
63586358
</div>
63596359
<div class="paragraph">
63606360
<p>For further information about telemetry in F Prime, see the
6361-
<a href="https://github.com/nasa/fprime/blob/master/docs/UsersGuide/guide.md">F Prime User&#8217;s Guide</a>.</p>
6361+
<a href="https://fprime.jpl.nasa.gov/latest/documentation/user-manual/">F Prime User Manual</a>.</p>
63626362
</div>
63636363
</div>
63646364
<div class="sect3">
@@ -6443,7 +6443,7 @@ <h4 id="Defining-Components_Special-Port-Instances_Parameter-Ports">10.3.4. Para
64436443
</div>
64446444
<div class="paragraph">
64456445
<p>For further information about parameters in F Prime, see the
6446-
<a href="https://github.com/nasa/fprime/blob/master/docs/UsersGuide/guide.md">F Prime User&#8217;s Guide</a>.</p>
6446+
<a href="https://fprime.jpl.nasa.gov/latest/documentation/user-manual/">F Prime User Manual</a>.</p>
64476447
</div>
64486448
</div>
64496449
<div class="sect3">
@@ -6493,7 +6493,7 @@ <h4 id="Defining-Components_Special-Port-Instances_Time-Get-Ports">10.3.5. Time
64936493
</div>
64946494
<div class="paragraph">
64956495
<p>For further information about time in F Prime, see the
6496-
<a href="https://github.com/nasa/fprime/blob/master/docs/UsersGuide/guide.md">F Prime User&#8217;s Guide</a>.</p>
6496+
<a href="https://fprime.jpl.nasa.gov/latest/documentation/user-manual/">F Prime User Manual</a>.</p>
64976497
</div>
64986498
</div>
64996499
<div class="sect3">
@@ -6616,8 +6616,8 @@ <h4 id="Defining-Components_Special-Port-Instances_Data-Product-Ports">10.3.6. D
66166616
</div>
66176617
<div class="paragraph">
66186618
<p>For further information about data products in F Prime, see the
6619-
<a href="https://github.com/nasa/fprime/blob/devel/docs/Design/data-products.md">data products documentation</a>
6620-
in the F Prime repository.</p>
6619+
<a href="https://fprime.jpl.nasa.gov/latest/documentation/user-manual/design/data-products/">data
6620+
products documentation</a> in the F Prime repository.</p>
66216621
</div>
66226622
</div>
66236623
</div>
@@ -6761,7 +6761,7 @@ <h3 id="Defining-Components_Commands">10.5. Commands</h3>
67616761
<div class="paragraph">
67626762
<p>For complete information about F Prime command dispatch and
67636763
handling, see the
6764-
<a href="https://github.com/nasa/fprime/blob/master/docs/UsersGuide/guide.md">F Prime User&#8217;s Guide</a>.
6764+
<a href="https://fprime.jpl.nasa.gov/latest/documentation/user-manual/">F Prime User Manual</a>.
67656765
Here we concentrate on how to specify commands in FPP.</p>
67666766
</div>
67676767
<div class="sect3">
@@ -7124,7 +7124,7 @@ <h3 id="Defining-Components_Events">10.6. Events</h3>
71247124
<div class="paragraph">
71257125
<p>For complete information about F Prime event
71267126
handling, see the
7127-
<a href="https://github.com/nasa/fprime/blob/master/docs/UsersGuide/guide.md">F Prime User&#8217;s Guide</a>.
7127+
<a href="https://fprime.jpl.nasa.gov/latest/documentation/user-manual/">F Prime User Manual</a>.
71287128
Here we concentrate on how to specify events in FPP.</p>
71297129
</div>
71307130
<div class="sect3">
@@ -7423,7 +7423,7 @@ <h4 id="Defining-Components_Events_Throttling">10.6.4. Throttling</h4>
74237423
emit the event until the throttling is canceled.
74247424
Typically, the canceling happens via a FSW command.
74257425
For details, see the
7426-
<a href="https://github.com/nasa/fprime/blob/master/docs/UsersGuide/guide.md">F Prime User&#8217;s Guide</a>.</p>
7426+
<a href="https://fprime.jpl.nasa.gov/latest/documentation/user-manual/">F Prime User Manual</a>.</p>
74277427
</div>
74287428
</div>
74297429
</div>
@@ -7444,7 +7444,7 @@ <h3 id="Defining-Components_Telemetry">10.7. Telemetry</h3>
74447444
<div class="paragraph">
74457445
<p>For complete information about F Prime telemetry
74467446
handling, see the
7447-
<a href="https://github.com/nasa/fprime/blob/master/docs/UsersGuide/guide.md">F Prime User&#8217;s Guide</a>.
7447+
<a href="https://fprime.jpl.nasa.gov/latest/documentation/user-manual/">F Prime User Manual</a>.
74487448
Here we concentrate on how to specify telemetry channels in FPP.</p>
74497449
</div>
74507450
<div class="sect3">
@@ -7804,7 +7804,7 @@ <h3 id="Defining-Components_Parameters">10.8. Parameters</h3>
78047804
database component for storing parameters in a non-volatile
78057805
manner (e.g., on a file system).
78067806
For complete information about F Prime parameters, see the
7807-
<a href="https://github.com/nasa/fprime/blob/master/docs/UsersGuide/guide.md">F Prime User&#8217;s Guide</a>.
7807+
<a href="https://fprime.jpl.nasa.gov/latest/documentation/user-manual/">F Prime User Manual</a>.
78087808
Here we concentrate on how to specify parameters in FPP.</p>
78097809
</div>
78107810
<div class="sect3">
@@ -8135,8 +8135,8 @@ <h3 id="Defining-Components_Data-Products">10.9. Data Products</h3>
81358135
(2) writing data products to the file system; and (3)
81368136
cataloging stored data products for downlink in priority order.
81378137
For more information about these F Prime features, see the
8138-
<a href="https://github.com/nasa/fprime/blob/devel/docs/Design/data-products.md">F Prime
8139-
data products documentation</a>.</p>
8138+
<a href="https://fprime.jpl.nasa.gov/latest/documentation/user-manual/">F Prime data
8139+
products documentation</a>.</p>
81408140
</div>
81418141
<div class="sect3">
81428142
<h4 id="Defining-Components_Data-Products_Basic-Data-Products">10.9.1. Basic Data Products</h4>
@@ -8149,7 +8149,7 @@ <h4 id="Defining-Components_Data-Products_Basic-Data-Products">10.9.1. Basic Dat
81498149
representing a list of serialized <strong>records</strong>.
81508150
A record is a unit of data.
81518151
For a complete specification of the container format, see the
8152-
<a href="https://github.com/nasa/fprime/blob/devel/Fw/Dp/docs/sdd.md">documentation</a>
8152+
<a href="https://fprime.jpl.nasa.gov/latest/documentation/reference/api/cpp/html/_fw_dp.html">documentation</a>
81538153
on F Prime framework support for data products.</p>
81548154
</div>
81558155
<div class="paragraph">
@@ -8215,7 +8215,7 @@ <h4 id="Defining-Components_Data-Products_Basic-Data-Products">10.9.1. Basic Dat
82158215
<p>The FPP back end uses this specification to generate code for requesting
82168216
buffers to hold containers and for serializing records into containers.
82178217
See the
8218-
<a href="https://github.com/nasa/fprime/blob/devel/docs/Design/data-products.md">F
8218+
<a href="https://fprime.jpl.nasa.gov/latest/documentation/user-manual/design/data-products/">F
82198219
Prime data products documentation</a> for the details.</p>
82208220
</div>
82218221
<div class="paragraph">
@@ -8456,7 +8456,7 @@ <h3 id="Defining-Components_State-Machine-Instances">10.10. State Machine Instan
84568456
machine definitions may be internal (specified in FPP) or external (specified
84578457
by an external tool). For more details about the C&#43;&#43; code generation for
84588458
instances of internal state machines, see the
8459-
<a href="https://github.com/nasa/fprime/blob/devel/docs/Design/general.md">F Prime design
8459+
<a href="https://fprime.jpl.nasa.gov/latest/documentation/user-manual/">F Prime design
84608460
documentation</a>.</p>
84618461
</div>
84628462
</div>
@@ -12988,25 +12988,26 @@ <h4 id="Analyzing-and-Translating-Models_Generating-C-Plus-Plus_Types-Ports-Stat
1298812988
<div class="paragraph">
1298912989
<p>Once you generate C&#43;&#43; code for these definitions, you can use it to
1299012990
write a flight software implementation.
12991-
The <a href="https://github.com/nasa/fprime/blob/master/docs/UsersGuide/guide.md">F
12992-
Prime User&#8217;s Guide</a> explains how to do this.</p>
12991+
The <a href="https://fprime.jpl.nasa.gov/latest/documentation/user-manual/">F
12992+
User Manual</a> explains how to do this.</p>
1299312993
</div>
1299412994
<div class="paragraph">
1299512995
<p>For more information about the generated code for data products,
1299612996
for state machines, and for state machine instances, see the
12997-
<a href="https://github.com/nasa/fprime/blob/devel/docs/Design/general.md">F Prime design
12998-
documentation</a>.</p>
12997+
<a href="https://fprime.jpl.nasa.gov/latest/documentation/user-manual/">F
12998+
Prime design documentation</a>.</p>
1299912999
</div>
1300013000
</div>
1300113001
<div class="sect3">
1300213002
<h4 id="Analyzing-and-Translating-Models_Generating-C-Plus-Plus_Component-Implementation-and-Unit-Test-Code">14.3.3. Component Implementation and Unit Test Code</h4>
1300313003
<div class="paragraph">
13004-
<p><code>fpp-to-cpp</code> has options <code>-t</code> and <code>-u</code> for generating component &#8220;templates&#8221; or
13004+
<p><code>fpp-to-cpp</code> has options <code>-t</code> and <code>-u</code> for generating component &#8220;templates&#8221;
13005+
or
1300513006
partial implementations and for generating unit test code.
1300613007
Here we cover the mechanics of using these options.
1300713008
For more information on implementing and testing components in F Prime, see
13008-
the <a href="https://github.com/nasa/fprime/blob/master/docs/UsersGuide/guide.md">F
13009-
Prime User&#8217;s Guide</a>.</p>
13009+
the <a href="https://fprime.jpl.nasa.gov/latest/documentation/user-manual/">F
13010+
Prime User Manual</a>.</p>
1301013011
</div>
1301113012
<div class="paragraph">
1301213013
<p><strong>Generating implementation templates:</strong>
@@ -13915,12 +13916,13 @@ <h3 id="Analyzing-and-Translating-Models_Generating-Ground-Dictionaries">14.8. G
1391513916
</div>
1391613917
<div class="paragraph">
1391713918
<p><strong>Tool behavior:</strong>
13918-
For each topology <em>T</em> defined in the input files <em>F</em>, <code>fpp-to-dict</code> writes a file
13919+
For each topology <em>T</em> defined in the input files <em>F</em>, <code>fpp-to-dict</code> writes a
13920+
file
1391913921
<em>T</em> <code>TopologyDictionary.json</code>.
1392013922
The dictionary is specified in JavaScript Object Notation (JSON) format.
1392113923
The JSON format is specified in the
13922-
<a href="https://github.com/nasa/fprime/blob/devel/docs/Design/fpp-json-dict.md">F Prime
13923-
dictionary documentation</a>.</p>
13924+
<a href="https://fprime.jpl.nasa.gov/latest/documentation/user-manual/design/fpp-json-dict/">F
13925+
Prime dictionary documentation</a>.</p>
1392413926
</div>
1392513927
<div class="paragraph">
1392613928
<p>Here is a common use case:</p>
@@ -14754,7 +14756,7 @@ <h4 id="Writing-C-Plus-Plus-Implementations_Implementing-Deployments_Public-Symb
1475414756
</div>
1475514757
<div id="footer">
1475614758
<div id="footer-text">
14757-
Last updated 2024-12-04 15:31:01 -0800
14759+
Last updated 2024-12-09 16:59:59 -0800
1475814760
</div>
1475914761
</div>
1476014762
<script src="code-prettify/run_prettify.js"></script>

docs/users-guide/Analyzing-and-Translating-Models.adoc

Lines changed: 12 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -566,22 +566,23 @@ uses the name `A_B_CComponentAc_HPP` in its include guard.
566566

567567
Once you generate {cpp} code for these definitions, you can use it to
568568
write a flight software implementation.
569-
The https://github.com/nasa/fprime/blob/master/docs/UsersGuide/guide.md[F
570-
Prime User's Guide] explains how to do this.
569+
The https://fprime.jpl.nasa.gov/latest/documentation/user-manual/[F
570+
User Manual] explains how to do this.
571571

572572
For more information about the generated code for data products,
573573
for state machines, and for state machine instances, see the
574-
https://github.com/nasa/fprime/blob/devel/docs/Design/general.md[F Prime design
575-
documentation].
574+
https://fprime.jpl.nasa.gov/latest/documentation/user-manual/[F
575+
Prime design documentation].
576576

577577
==== Component Implementation and Unit Test Code
578578

579-
`fpp-to-cpp` has options `-t` and `-u` for generating component "`templates`" or
579+
`fpp-to-cpp` has options `-t` and `-u` for generating component "`templates`"
580+
or
580581
partial implementations and for generating unit test code.
581582
Here we cover the mechanics of using these options.
582583
For more information on implementing and testing components in F Prime, see
583-
the https://github.com/nasa/fprime/blob/master/docs/UsersGuide/guide.md[F
584-
Prime User's Guide].
584+
the https://fprime.jpl.nasa.gov/latest/documentation/user-manual/[F
585+
Prime User Manual].
585586

586587
*Generating implementation templates:*
587588
When you run `fpp-to-cpp` with option `-t` and without option `-u`,
@@ -1312,12 +1313,13 @@ Except for the tool name, this procedure is identical to the one given for
13121313
either through named files or through standard input.
13131314

13141315
*Tool behavior:*
1315-
For each topology _T_ defined in the input files _F_, `fpp-to-dict` writes a file
1316+
For each topology _T_ defined in the input files _F_, `fpp-to-dict` writes a
1317+
file
13161318
_T_ `TopologyDictionary.json`.
13171319
The dictionary is specified in JavaScript Object Notation (JSON) format.
13181320
The JSON format is specified in the
1319-
https://github.com/nasa/fprime/blob/devel/docs/Design/fpp-json-dict.md[F Prime
1320-
dictionary documentation].
1321+
https://fprime.jpl.nasa.gov/latest/documentation/user-manual/design/fpp-json-dict/[F
1322+
Prime dictionary documentation].
13211323

13221324
Here is a common use case:
13231325

0 commit comments

Comments
 (0)