Skip to content

Commit 494327f

Browse files
authored
replace @ignore with @hidden (Azure#12963)
`@ignore` is a JSDoc construct which we no longer use. This PR replaces it with `TypeDoc`'s `@hidden` which [exhibits the same behavior](https://github.com/TypeStrong/typedoc/releases/tag/v0.12.0).
1 parent 90f9d8e commit 494327f

File tree

196 files changed

+702
-638
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

196 files changed

+702
-638
lines changed

sdk/appconfiguration/app-configuration/src/internal/helpers.ts

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -161,8 +161,8 @@ export function makeConfigurationSettingEmpty(
161161
}
162162

163163
/**
164-
* @internal
165164
* @hidden
165+
* @internal
166166
*/
167167
export function transformKeyValue(kvp: KeyValue): ConfigurationSetting {
168168
const obj: ConfigurationSetting & KeyValue = {
@@ -175,8 +175,8 @@ export function transformKeyValue(kvp: KeyValue): ConfigurationSetting {
175175
}
176176

177177
/**
178-
* @internal
179178
* @hidden
179+
* @internal
180180
*/
181181
export function transformKeyValueResponseWithStatusCode<
182182
T extends KeyValue & HttpResponseField<any>
@@ -190,8 +190,8 @@ export function transformKeyValueResponseWithStatusCode<
190190
}
191191

192192
/**
193-
* @internal
194193
* @hidden
194+
* @internal
195195
*/
196196
export function transformKeyValueResponse<
197197
T extends KeyValue & { eTag?: string } & HttpResponseField<any>

sdk/appconfiguration/app-configuration/tsdoc.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,4 +3,4 @@
33
"extends": [
44
"../../../tsdoc.json"
55
]
6-
}
6+
}

sdk/core/core-amqp/src/connectionConfig/connectionConfig.ts

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -167,7 +167,7 @@ export const ConnectionConfig = {
167167

168168
/**
169169
* @internal
170-
* @ignore
170+
* @hidden
171171
*/
172172
export function isSharedAccessSignature(connectionString: string): boolean {
173173
return connectionString.match(/;{0,1}SharedAccessSignature=SharedAccessSignature /) != null;

sdk/core/core-amqp/src/errors.ts

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ import { isNode, isNumber, isString } from "../src/util/utils";
99
* Maps the conditions to the numeric AMQP Response status codes.
1010
* @enum {ConditionStatusMapper}
1111
* @internal
12-
* @ignore
12+
* @hidden
1313
*/
1414
export enum ConditionStatusMapper {
1515
"com.microsoft:timeout" = AmqpResponseStatusCode.RequestTimeout,
@@ -457,7 +457,7 @@ export interface NetworkSystemError {
457457

458458
/**
459459
* @internal
460-
* @ignore
460+
* @hidden
461461
*/
462462
const systemErrorFieldsToCopy: (keyof Omit<NetworkSystemError, "name" | "message">)[] = [
463463
"address",
@@ -608,7 +608,7 @@ export function isSystemError(err: any): err is NetworkSystemError {
608608

609609
/**
610610
* @internal
611-
* @ignore
611+
* @hidden
612612
* Since browser doesn't differentiate between the various kinds of service communication errors,
613613
* this utility is used to look at the error target to identify such category of errors.
614614
* For more information refer to - https://html.spec.whatwg.org/multipage/comms.html#feedback-from-the-protocol
@@ -629,7 +629,7 @@ function isBrowserWebsocketError(err: any): boolean {
629629

630630
/**
631631
* @internal
632-
* @ignore
632+
* @hidden
633633
*/
634634
const rheaPromiseErrors = [
635635
// OperationTimeoutError occurs when the service fails to respond within a given timeframe.
@@ -729,7 +729,7 @@ export function translate(err: AmqpError | Error): MessagingError | Error {
729729

730730
/**
731731
* @internal
732-
* @ignore
732+
* @hidden
733733
*
734734
* @param {*} error
735735
* @returns {error is AmqpError}

sdk/core/core-amqp/src/log.ts

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ export const logger = createClientLogger("core-amqp");
1212
/**
1313
* Logs the error's stack trace to "verbose" if a stack trace is available.
1414
* @param error Error containing a stack trace.
15-
* @ignore
15+
* @hidden
1616
*/
1717
export function logErrorStackTrace(error: any): void {
1818
if (error && error.stack) {

sdk/core/core-amqp/src/requestResponseLink.ts

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,7 @@ export interface SendRequestOptions {
4040

4141
/**
4242
* @internal
43-
* @ignore
43+
* @hidden
4444
*/
4545
export interface DeferredPromiseWithCallback {
4646
resolve: (value?: any) => void;
@@ -230,7 +230,7 @@ export class RequestResponseLink implements ReqResLink {
230230
}
231231
/**
232232
* @internal
233-
* @ignore
233+
* @hidden
234234
*
235235
* Type used in getCodeDescriptionAndError to get the normalized info from the responses emitted by EventHubs and ServiceBus.
236236
*/
@@ -242,7 +242,7 @@ type NormalizedInfo = {
242242

243243
/**
244244
* @internal
245-
* @ignore
245+
* @hidden
246246
*
247247
* Handle different variations of property names in responses emitted by EventHubs and ServiceBus.
248248
*
@@ -271,7 +271,7 @@ export const getCodeDescriptionAndError = (props: any): NormalizedInfo => {
271271
* 5. User's code after the sendRequest continues.
272272
*
273273
* @internal
274-
* @ignore
274+
* @hidden
275275
*/
276276
export function onMessageReceived(
277277
context: Pick<EventContext, "message">,

sdk/core/core-amqp/src/retry.ts

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ import { checkNetworkConnection } from "./util/checkNetworkConnection";
1111

1212
/**
1313
* Determines whether the object is a Delivery object.
14-
* @ignore
14+
* @hidden
1515
*/
1616
function isDelivery(obj: any): boolean {
1717
let result: boolean = false;
@@ -119,7 +119,7 @@ export interface RetryConfig<T> {
119119

120120
/**
121121
* Validates the retry config.
122-
* @ignore
122+
* @hidden
123123
*/
124124
function validateRetryConfig<T>(config: RetryConfig<T>): void {
125125
if (!config.operation) {

sdk/core/core-amqp/src/util/checkNetworkConnection.browser.ts

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33

44
/**
55
* Checks whether a network connection is detected.
6-
* @ignore
6+
* @hidden
77
* @internal
88
*/
99
export function checkNetworkConnection(): Promise<boolean> {

sdk/core/core-amqp/src/util/checkNetworkConnection.ts

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ import { logger } from "../log";
66

77
/**
88
* Checks whether a network connection is detected.
9-
* @ignore
9+
* @hidden
1010
* @internal
1111
*/
1212
export function checkNetworkConnection(host: string): Promise<boolean> {

sdk/core/core-amqp/src/util/runtimeInfo.browser.ts

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -3,21 +3,21 @@
33

44
/**
55
* @internal
6-
* @ignore
6+
* @hidden
77
*
88
* @interface Window
99
*/
1010
interface Window {}
1111

1212
/**
1313
* @internal
14-
* @ignore
14+
* @hidden
1515
*/
1616
declare let self: Window & typeof globalThis & { navigator: Navigator };
1717

1818
/**
1919
* @internal
20-
* @ignore
20+
* @hidden
2121
*
2222
* @interface Navigator
2323
*/
@@ -30,7 +30,7 @@ interface Navigator {
3030

3131
/**
3232
* Returns information about the platform this function is being run on.
33-
* @ignore
33+
* @hidden
3434
* @internal
3535
*/
3636
export function getPlatformInfo(): string {
@@ -39,7 +39,7 @@ export function getPlatformInfo(): string {
3939

4040
/**
4141
* Returns information about Node.js this function is being run on.
42-
* @ignore
42+
* @hidden
4343
* @internal
4444
*/
4545
export function getFrameworkInfo(): string {
@@ -48,7 +48,7 @@ export function getFrameworkInfo(): string {
4848

4949
/**
5050
* @internal
51-
* @ignore
51+
* @hidden
5252
*
5353
* @returns {string}
5454
*/

0 commit comments

Comments
 (0)