df378d33ef
Some checks failed
CI / go (push) Waiting to run
CI / docker (push) Waiting to run
CI / lint-go (push) Waiting to run
CI / lint-docs (push) Waiting to run
CI / check-paperclip (push) Waiting to run
Deploy static site / Deploy to GitHub Pages (push) Has been cancelled
Deploy static site / Deploy via Docker to hatch.surf (push) Has been cancelled
Resolved conflicts by taking GitHub versions for: - .dockerignore, .gitignore, Dockerfile, README.md, docker-compose.yml Kept deploy.sh updated to: - Pull from GitHub (primary source) - Push to Gitea (push-mirror) - Build from site/ directory (GitHub structure) Co-Authored-By: Paperclip <noreply@paperclip.ing>
63 lines
1.4 KiB
Markdown
63 lines
1.4 KiB
Markdown
# import/no-deprecated
|
|
|
|
<!-- end auto-generated rule header -->
|
|
|
|
Reports use of a deprecated name, as indicated by a JSDoc block with a `@deprecated`
|
|
tag or TomDoc `Deprecated:` comment.
|
|
|
|
using a JSDoc `@deprecated` tag:
|
|
|
|
```js
|
|
// @file: ./answer.js
|
|
|
|
/**
|
|
* this is what you get when you trust a mouse talk show
|
|
* @deprecated need to restart the experiment
|
|
* @returns {Number} nonsense
|
|
*/
|
|
export function multiply(six, nine) {
|
|
return 42
|
|
}
|
|
```
|
|
|
|
will report as such:
|
|
|
|
```js
|
|
import { multiply } from './answer' // Deprecated: need to restart the experiment
|
|
|
|
function whatever(y, z) {
|
|
return multiply(y, z) // Deprecated: need to restart the experiment
|
|
}
|
|
```
|
|
|
|
or using the TomDoc equivalent:
|
|
|
|
```js
|
|
// Deprecated: This is what you get when you trust a mouse talk show, need to
|
|
// restart the experiment.
|
|
//
|
|
// Returns a Number nonsense
|
|
export function multiply(six, nine) {
|
|
return 42
|
|
}
|
|
```
|
|
|
|
Only JSDoc is enabled by default. Other documentation styles can be enabled with
|
|
the `import/docstyle` setting.
|
|
|
|
```yaml
|
|
# .eslintrc.yml
|
|
settings:
|
|
import/docstyle: ['jsdoc', 'tomdoc']
|
|
```
|
|
|
|
## Worklist
|
|
|
|
- [x] report explicit imports on the import node
|
|
- [x] support namespaces
|
|
- [x] should bubble up through deep namespaces (#157)
|
|
- [x] report explicit imports at reference time (at the identifier) similar to namespace
|
|
- [x] mark module deprecated if file JSDoc has a @deprecated tag?
|
|
- [ ] don't flag redeclaration of imported, deprecated names
|
|
- [ ] flag destructuring
|