aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--ChangeLog7
-rw-r--r--doc/dejagnu.texi43
2 files changed, 32 insertions, 18 deletions
diff --git a/ChangeLog b/ChangeLog
index 40d4386..a72565d 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,10 @@
+2020-05-26 Jacob Bachmeyer <jcb62281+dev@gmail.com>
+
+ * doc/dejagnu.texi (target_link procedure): New stub node.
+ (default_link procedure): Document internal procedure.
+ (default_target_assemble procedure): Likewise.
+ (default_target_compile procedure): Likewise.
+
2020-05-20 Jacob Bachmeyer <jcb62281+dev@gmail.com>
* baseboards/{aarch64-sim, arm-ice, arm-sim, basic-sid, iq2000-sim,
diff --git a/doc/dejagnu.texi b/doc/dejagnu.texi
index 34b11a1..5f293a4 100644
--- a/doc/dejagnu.texi
+++ b/doc/dejagnu.texi
@@ -4408,6 +4408,7 @@ This is the filename to download.
* reboot_target Procedure: reboot_target procedure
* target_assemble Procedure: target_assemble procedure
* target_compile Procedure: target_compile procedure
+* target_link Procedure: target_link procedure
@end menu
@node default_link procedure, default_target_assemble procedure, , Procedures For Target Boards
@@ -4418,12 +4419,8 @@ This is the filename to download.
@t{@b{default_link} @i{board} @i{objects} @i{destfile} @i{flags}}
@end quotation
-@table @asis
-@item @code{board}
-@item @code{objects}
-@item @code{destfile}
-@item @code{flags}
-@end table
+This is the internal implementation for the @ref{target_link
+procedure}, and should not be directly called from testsuite code.
@node default_target_assemble procedure, default_target_compile procedure, default_link procedure, Procedures For Target Boards
@subsubheading default_target_assemble Procedure
@@ -4433,11 +4430,8 @@ This is the filename to download.
@t{@b{default_target_assemble} @i{source} @i{destfile} @i{flags}}
@end quotation
-@table @asis
-@item @code{source}
-@item @code{destfile}
-@item @code{flags}
-@end table
+This is the internal implementation for the @ref{target_assemble
+procedure}, and should not be directly called from testsuite code.
@node default_target_compile procedure, pop_config procedure, default_target_assemble procedure, Procedures For Target Boards
@subsubheading default_target_compile Procedure
@@ -4448,12 +4442,11 @@ This is the filename to download.
@i{options}}
@end quotation
-@table @asis
-@item @code{source}
-@item @code{destfile}
-@item @code{type}
-@item @code{options}
-@end table
+This is the default implementation for the @ref{target_compile
+procedure}, and is used if the current target board does not have a
+special procedure for this purpose. @xref{target_compile procedure},
+for API details. Calling this procedure directly from testsuite code
+is deprecated.
@node pop_config procedure, prune_warnings procedure, default_target_compile procedure, Procedures For Target Boards
@subsubheading pop_config Procedure
@@ -4529,7 +4522,7 @@ Reboot the target.
@item @code{flags}
@end table
-@node target_compile procedure, , target_assemble procedure, Procedures For Target Boards
+@node target_compile procedure, target_link procedure, target_assemble procedure, Procedures For Target Boards
@subsubheading target_compile Procedure
@findex target_compile
@@ -4544,6 +4537,20 @@ Reboot the target.
@item @code{options}
@end table
+@node target_link procedure, , target_compile procedure, Procedures For Target Boards
+@subsubheading target_link Procedure
+@findex target_link
+
+@quotation
+@t{@b{target_link} @i{objects} @i{destfile} @i{flags}}
+@end quotation
+
+@table @asis
+@item @code{objects}
+@item @code{destfile}
+@item @code{flags}
+@end table
+
@node target database library file, platform dependent procedures, Procedures For Target Boards, Built-in Procedures
@section Target Database Procedures