Skip to content

Commit 686227c

Browse files
committed
[pipeline] Fix broken intra-doc link of YDBError -> Display
**Change** * Pipeline job `pages` started failing because of the error shown below ``` Found invalid urls in struct.Context.html: Fragment #impl-Display at struct.YDBError.html does not exist! ``` * This error is from execution of `cargo deadlinks` command * This error is due to the fact that implementation of trait `fmt::Display` for `YDBError` was not found at fragment `impl-Display` of `struct.YDBError.html` * This error started occuring with the `rust version 1.64.0 (a55dd71d5 2022-09-19)` and not before. The previous version as seen in pipeline jobs previous to this failure is `1.63.0 (4b91a6ea7 2022-08-08)` * When attempted to generate the docs locally it was found that the documentation for `Display` with the new rust version (1.64.0) was seen at fragment `impl-Display-for-YDBError` * Changing the fragment part in rustdoc solved the issue * The following pull request seems to have introduced this change to rustdoc rust-lang/rust#98939 (rustdoc: Add more semantic information to impl IDs #98939) and this is the issue on github related to this change -> rust-lang/rust#92052 (rustdoc: Semantically disambiguate impls and associated impl items rather than using numeric suffixes #92052) **Misc** * @jsikri94 found another issue where the intra-doc link format was broken. This change also fixed the issue. * Previous to this change following line was seen in docs : `ci_t! and cip_t! cip_t!: crate::cip_t! ci_t!: crate::ci_t!` * After this change it is replaced by : `ci_t! and cip_t!` * The fix was to include an empty line between the intra link and its definition. As it was absent both the lines were being combined into one as seen above in the first sub-point. With the empty line the line seen in docs is fixed and is seen as shown by the second sub-point above.
1 parent 910b73f commit 686227c

File tree

2 files changed

+2
-1
lines changed

2 files changed

+2
-1
lines changed

src/context_api/call_in.rs

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -133,6 +133,7 @@ impl Context {
133133
/// - [C SimpleAPI documentation](https://docs.yottadb.com/MultiLangProgGuide/cprogram.html#ydb-ci-tab-open-ydb-ci-tab-open-t)
134134
/// - [Call-in interface](https://docs.yottadb.com/ProgrammersGuide/extrout.html#call-in-interface)
135135
/// - [`ci_t!`] and [`cip_t!`]
136+
///
136137
/// [`cip_t!`]: crate::cip_t!
137138
/// [`ci_t!`]: crate::ci_t!
138139
///

src/context_api/mod.rs

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -629,7 +629,7 @@ impl Context {
629629
/// - [ZMessage codes](https://docs.yottadb.com/MessageRecovery/errormsgref.html#zmessage-codes)
630630
/// - The [C documentation](https://docs.yottadb.com/MultiLangProgGuide/cprogram.html#ydb-message-ydb-message-t)
631631
///
632-
/// [`impl Display`]: YDBError#impl-Display
632+
/// [`impl Display`]: YDBError#impl-Display-for-YDBError
633633
///
634634
/// # Example
635635
/// Look up the error message for an undefined local variable:

0 commit comments

Comments
 (0)