use eslint-plugin-jsdoc in Thunderbird code (like bug 1510561)
Categories
(Thunderbird :: General, enhancement)
Tracking
(Not tracked)
People
(Reporter: mkmelin, Assigned: mkmelin)
References
Details
(Keywords: helpwanted, leave-open)
Attachments
(3 files, 1 obsolete file)
+++ This bug was initially created as a clone of Bug #1510561 +++
Assignee | ||
Updated•2 years ago
|
Assignee | ||
Comment 1•2 years ago
|
||
Updated•2 years ago
|
Updated•2 years ago
|
Pushed by alessandro@thunderbird.net:
https://hg.mozilla.org/comm-central/rev/bafa5ef68e1a
use eslint-plugin-jsdoc in mailnews/test/. r=aleca
Assignee | ||
Comment 3•2 years ago
|
||
Plenty of work left to do here. If other people as well want to take on fixing up chunks of the code base that would be great.
How? Take some suitable size directory, add/change the .eslint.rc file like https://hg.mozilla.org/comm-central/diff/bafa5ef68e1ab977f5ba3f1180e7698a512099bb/mailnews/test/resources/.eslintrc.js#l1.8. Then run ../mach eslint --fix <dir>
and go through the errors adjusting/adding type documentation for the functions. It's not hard, but pretty tedious work...
Assignee | ||
Updated•2 years ago
|
Comment 4•2 years ago
|
||
Ah nice, thanks for the heads up and info.
Should we share this in a couple of our mailing lists? Like tb-developers?
Assignee | ||
Comment 5•2 years ago
|
||
Yep, I'll send out a call and see if we could get someone interested.
Assignee | ||
Comment 6•2 years ago
|
||
This is the automatic fixes + whitespace fixup:
find . -type f -not -path "./suite/" -name ".js" -exec sed -i -E 's/* @returns +/* @returns /g' {} ;
find . -type f -not -path "./suite/" -name ".jsm" -exec sed -i -E 's/* @returns +/* @returns /g' {} ;
find . -type f -not -path "./suite/" -name ".js" -exec sed -i -E 's/* (@returns {.+}) +/* \1 /g' {} ;
find . -type f -not -path "./suite/" -name ".jsm" -exec sed -i -E 's/* (@returns {.+}) +/* \1 /g' {} ;
find . -type f -not -path "./suite/" -name ".js" -exec sed -i -E 's/*( @param)( \S+ \S+ ) +/\1\2- /g' {} ;
find . -type f -not -path "./suite/" -name ".jsm" -exec sed -i -E 's/*( @param)( \S+ \S+ ) +/\1\2- /g' {} ;
find . -type f -not -path "./suite/" -name ".js" -exec sed -i -E 's/*( @param[^-])( - - )/\1 - /g' {} ;
find . -type f -not -path "./suite/" -name ".jsm" -exec sed -i -E 's/*( @param[^-])( - - )/\1 - /g' {} ;
Pushed by mkmelin@iki.fi: https://hg.mozilla.org/comm-central/rev/a74696f86d12 mozilla/valid-jsdoc automatic fixups across the Thunderbird codebase. r=aleca
Pushed by mkmelin@iki.fi: https://hg.mozilla.org/comm-central/rev/534b098204d0 small documentation improvement. rs=me
Pushed by mkmelin@iki.fi: https://hg.mozilla.org/comm-central/rev/7d4a6859eeb7 use eslint-plugin-jsdoc for mailnews/addrbook. r=me
Comment 10•2 years ago
|
||
Pushed by mkmelin@iki.fi: https://hg.mozilla.org/comm-central/rev/6f6b36b28568 use eslint-plugin-jsdoc for mailnews/base/content. rs=me
Comment 11•2 years ago
|
||
Pushed by mkmelin@iki.fi: https://hg.mozilla.org/comm-central/rev/13e6128078c3 use eslint-plugin-jsdoc for mailnews/base/test. rs=me
Comment 12•2 years ago
|
||
Pushed by mkmelin@iki.fi: https://hg.mozilla.org/comm-central/rev/d1470f8f1fa5 use eslint-plugin-jsdoc for mailnews/base/prefs. rs=me
Comment 13•2 years ago
|
||
Pushed by mkmelin@iki.fi: https://hg.mozilla.org/comm-central/rev/7be6ce5b7a78 Fix ABQueryUtils.jsm for eslint-plugin-jsdoc. rs=me
Comment 14•1 year ago
|
||
Pushed by mkmelin@iki.fi: https://hg.mozilla.org/comm-central/rev/4e10ded905be use eslint-plugin-jsdoc for mailnews/base/. rs=me
Comment 15•1 year ago
|
||
Pushed by mkmelin@iki.fi: https://hg.mozilla.org/comm-central/rev/38d054301e29 use eslint-plugin-jsdoc for mailnews/compose/. rs=me
Comment 16•1 year ago
|
||
Pushed by mkmelin@iki.fi: https://hg.mozilla.org/comm-central/rev/8bee010addb9 use eslint-plugin-jsdoc for mailnews/db/msgdb. rs=me
Comment 17•1 year ago
|
||
Pushed by mkmelin@iki.fi: https://hg.mozilla.org/comm-central/rev/cfee64616363 use eslint-plugin-jsdoc for mailnews/export. rs=me
Comment 18•1 year ago
|
||
Pushed by mkmelin@iki.fi: https://hg.mozilla.org/comm-central/rev/8b16f2740a9b Fix param documentation in MimeMessageEmitter.jsm, for eslint-plugin-jsdoc. rs=me
Comment 19•1 year ago
|
||
Pushed by brendan@thunderbird.net: https://hg.mozilla.org/comm-central/rev/cc8acead07bb Add missing jsdoc for restoreState in about3Pane.js. rs=me
Comment 20•1 year ago
|
||
Pushed by mkmelin@iki.fi: https://hg.mozilla.org/comm-central/rev/e8a7cd1b6004 Fix param doc for mailnews/db/gloda/test/unit/test_query_core.js. rs=me
Comment 21•1 year ago
|
||
Pushed by mkmelin@iki.fi: https://hg.mozilla.org/comm-central/rev/43bf9bf63f96 Fix param docs for mailnews/db/gloda/test/unit/test_msg_search.js. rs=me
Comment 22•1 year ago
|
||
Pushed by mkmelin@iki.fi: https://hg.mozilla.org/comm-central/rev/ed38c79d6908 Fix param docs for mailnews/db/gloda/test/unit/resources/GlodaTestHelperFunctions.jsm. rs=me
Comment 23•1 year ago
|
||
Pushed by mkmelin@iki.fi: https://hg.mozilla.org/comm-central/rev/f3ed489f8920 Fix param docs for mailnews/db/gloda/modules/Collection.jsm. rs=me
Comment 24•1 year ago
|
||
Pushed by mkmelin@iki.fi: https://hg.mozilla.org/comm-central/rev/7b9d2d37344a apply eslint-plugin-jsdoc formatting to mail/extensions/openpgp/content/. rs=me
Comment 25•1 year ago
|
||
Pushed by mkmelin@iki.fi: https://hg.mozilla.org/comm-central/rev/87c2b2d63a21 Fix param docs in mail/extensions/openpgp/content/ui/keyWizard.js. rs=me
Comment 26•1 year ago
|
||
Pushed by mkmelin@iki.fi: https://hg.mozilla.org/comm-central/rev/34b005530548 Fix param docs in mail/extensions/openpgp/content/ui/keyDetailsDlg.js. rs=me
Comment 27•1 year ago
|
||
Pushed by mkmelin@iki.fi: https://hg.mozilla.org/comm-central/rev/35f6118a4b3b Fix jsdocs in zbase32.jsm. rs=me
Comment 28•1 year ago
|
||
Pushed by mkmelin@iki.fi: https://hg.mozilla.org/comm-central/rev/1650432fde3c Fix jsdocs in mail/extensions/openpgp/content/modules/wkdLookup.jsm. rs=me
Comment 29•1 year ago
|
||
Pushed by mkmelin@iki.fi: https://hg.mozilla.org/comm-central/rev/63592519735e Fix jsdocs in mail/extensions/openpgp/content/modules/fixExchangeMsg.jsm. rs=me
Comment 30•10 months ago
|
||
Pushed by mkmelin@iki.fi: https://hg.mozilla.org/comm-central/rev/5c342ce022f8 Make docs valid for eslint-plugin-jsdoc in trust.jsm and uris.jsm. rs=me
Comment 31•9 months ago
|
||
Pushed by mkmelin@iki.fi: https://hg.mozilla.org/comm-central/rev/1b235a26a2cb Make comments valid eslint-plugin-jsdoc in mail/extensions/openpgp/content/modules/sqliteDb.jsm. rs=me
Comment 32•8 months ago
|
||
Pushed by mkmelin@iki.fi: https://hg.mozilla.org/comm-central/rev/e223c580c99e use eslint-plugin-jsdoc for mail/extensions/openpgp/content/modules/keyObj.jsm. rs=me
Comment 33•8 months ago
|
||
Pushed by mkmelin@iki.fi: https://hg.mozilla.org/comm-central/rev/795f6c86c239 use eslint-plugin-jsdoc for mail/extensions/openpgp/content/modules/key.jsm. rs=me
Comment 34•7 months ago
|
||
Pushed by mkmelin@iki.fi: https://hg.mozilla.org/comm-central/rev/f7854b5e552d use eslint-plugin-jsdoc for mail/extensions/openpgp/content/modules/persistentCrypto.jsm. rs=me
Comment 35•7 months ago
|
||
Pushed by mkmelin@iki.fi: https://hg.mozilla.org/comm-central/rev/76a48901e920 use eslint-plugin-jsdoc for a bunch of calendar files. rs=me
Comment 36•7 months ago
|
||
Pushed by mkmelin@iki.fi: https://hg.mozilla.org/comm-central/rev/38df40cac35a use/fix eslint-plugin-jsdoc for some files in mail/extensions/openpgp/content/modules/. rs=me
Comment 37•7 months ago
|
||
Pushed by mkmelin@iki.fi: https://hg.mozilla.org/comm-central/rev/d810c836c906 Fix jsdocs for some parts of mail/extensions/openpgp/content/modules/. rs=me
Comment 38•7 months ago
|
||
Pushed by mkmelin@iki.fi: https://hg.mozilla.org/comm-central/rev/717e99adb1cd Fix jsdocs in mail/extensions/openpgp/content/modules/funcs.jsm. rs=me
Comment 39•7 months ago
|
||
Pushed by mkmelin@iki.fi: https://hg.mozilla.org/comm-central/rev/92be7cedf121 Fix jsdocs in mail/extensions/openpgp/content/modules/CollectedKeysDB.jsm. rs=me
Comment 40•7 months ago
|
||
Pushed by mkmelin@iki.fi: https://hg.mozilla.org/comm-central/rev/8382dcdee355 Fix jsdocs in mail/extensions/openpgp/content/modules/filtersWrapper.jsm. rs=me
Comment 41•6 months ago
|
||
Comment 42•6 months ago
|
||
Updated•6 months ago
|
Updated•6 months ago
|
Comment 43•6 months ago
|
||
Pushed by daniel@thunderbird.net:
https://hg.mozilla.org/comm-central/rev/5aabddb56705
Fix all known JSDoc syntax errors in calendar/base/. r=mkmelin
Comment 44•6 months ago
|
||
Pushed by mkmelin@iki.fi: https://hg.mozilla.org/comm-central/rev/11fee57bedf2 Fix jsdocs in mail/extensions/openpgp/content/modules/filters.sys.mjs. rs=me
Comment 45•6 months ago
|
||
Pushed by mkmelin@iki.fi: https://hg.mozilla.org/comm-central/rev/a72d21d1359a Fix jsdocs in mail/extensions/openpgp/content/modules/cryptoAPI/RNPCryptoAPI.sys.mjs. rs=me
Comment 46•5 months ago
|
||
Pushed by mkmelin@iki.fi: https://hg.mozilla.org/comm-central/rev/dae1b203991d Make decryption.sys.mjs pass for eslint-plugin-jsdoc. rs=me
Comment 47•5 months ago
|
||
Pushed by martin@humanoids.be: https://hg.mozilla.org/comm-central/rev/9ff490387b5e Enable mozilla/valid-jsdoc on chat imContentSink.sys.mjs. rs=me
Comment 48•5 months ago
|
||
Pushed by mkmelin@iki.fi: https://hg.mozilla.org/comm-central/rev/546741981c7f Fix jsdocs and enable eslint-plugin-jsdoc for openpgp. rs=me
Comment 49•5 months ago
|
||
Pushed by mkmelin@iki.fi: https://hg.mozilla.org/comm-central/rev/e6f861ff3e52 Fix jsdocs and enable eslint-plugin-jsdoc for smime. rs=me
Comment 50•5 months ago
|
||
Pushed by mkmelin@iki.fi: https://hg.mozilla.org/comm-central/rev/16c2a1fb97e9 Fix some jsdocs to pass enabling eslint-plugin-jsdoc in mail/modules. rs=me
Comment 51•4 months ago
|
||
Pushed by mkmelin@iki.fi: https://hg.mozilla.org/comm-central/rev/170ab35654bf Fix jsdocs in SummaryFrameManager.sys.mjs. rs=me
Comment 52•4 months ago
|
||
Pushed by mkmelin@iki.fi: https://hg.mozilla.org/comm-central/rev/5a275b0a6d1a Fix jsdocs in SessionStoreManager.sys.mjs. rs=me
Comment 53•4 months ago
|
||
Pushed by mkmelin@iki.fi: https://hg.mozilla.org/comm-central/rev/44d660019d79 Fix jsdocs in PhishingDetector.sys.mjs and SmartMailboxUtils.sys.mjs. r=me
Comment 54•4 months ago
|
||
Pushed by mkmelin@iki.fi: https://hg.mozilla.org/comm-central/rev/15c622826cd4 Fix jsdocs in MailUsageTelemetry.sys.mjs. r=me
Comment 55•4 months ago
|
||
Pushed by vineet@thunderbird.net: https://hg.mozilla.org/comm-central/rev/4f32ec2f7f1d Fix jsdocs in CreateInBackend.sys.mjs. r=me
Comment 56•4 months ago
|
||
Pushed by vineet@thunderbird.net: https://hg.mozilla.org/comm-central/rev/9605a97b8276 Fix jsdocs in CreateInBackend.sys.mjs. r=me
Comment 57•3 months ago
|
||
Pushed by mkmelin@iki.fi: https://hg.mozilla.org/comm-central/rev/3e0a6967e41c Fix jsdocs in mail/modules/DNS.sys.mjs. r=me
Comment 58•3 months ago
|
||
Pushed by mkmelin@iki.fi: https://hg.mozilla.org/comm-central/rev/ff4031ec4ca3 Fix jsdocs in mail/modules/DisplayNameUtils.sys.mjs. r=me
Comment 59•3 months ago
|
||
Pushed by mkmelin@iki.fi: https://hg.mozilla.org/comm-central/rev/629edc2fd9d1 Fix jsdocs in mail/modules/MailUtils.sys.mjs. rs=me
Comment 60•2 months ago
|
||
Pushed by martin@humanoids.be: https://hg.mozilla.org/comm-central/rev/060368fde23d Enable valid-jsdoc linter on inappnotifications component. rs=me
Comment 61•2 months ago
|
||
Pushed by mkmelin@iki.fi: https://hg.mozilla.org/comm-central/rev/f44d67b269d8 Fix jsdoc comments in mail/modules/MailMigrator.sys.mjs. rs=me
Comment 62•2 months ago
|
||
Pushed by mkmelin@iki.fi: https://hg.mozilla.org/comm-central/rev/580c84d5b649 Fix jsdoc comments in mail/modules/DisplayNameUtils.sys.mjs. rs=me
Comment 63•1 month ago
|
||
Pushed by mkmelin@iki.fi: https://hg.mozilla.org/comm-central/rev/547ff73480d6 Fix jsdoc comments in mail/modules/SearchSpec.sys.mjs. rs=me
Comment 64•27 days ago
|
||
Pushed by mkmelin@iki.fi: https://hg.mozilla.org/comm-central/rev/550bffaec934 Fix jsdoc comments in mail/modules/AttachmentInfo.sys.mjs. rs=me
Comment 65•26 days ago
|
||
Pushed by mkmelin@iki.fi: https://hg.mozilla.org/comm-central/rev/ef0cef8f43f0 Fix jsdoc comments in mail/modules/CommandController.mjs. rs=me
Comment 66•26 days ago
|
||
Pushed by mkmelin@iki.fi: https://hg.mozilla.org/comm-central/rev/efa443156a14 Fix jsdoc comments in mail/modules/PluralForm.sys.mjs. rs=me
Comment 67•23 days ago
|
||
Pushed by mkmelin@iki.fi: https://hg.mozilla.org/comm-central/rev/5ecd597d89d1 Fix jsdoc comments in mail/modules/ExtensionSupport.sys.mjs. rs=me
Comment 68•23 days ago
|
||
Pushed by mkmelin@iki.fi: https://hg.mozilla.org/comm-central/rev/14a070d6f633 Fix jsdoc comments in mail/modules/GlobalPopupNotifications.sys.mjs. rs=me
Comment 69•22 days ago
|
||
Pushed by mkmelin@iki.fi: https://hg.mozilla.org/comm-central/rev/bddc241fc3dd Fix jsdoc comments in mail/modules/DBViewWrapper.sys.mjs. rs=me
Description
•