yard 0.9.33 → 0.9.34

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 35a50468db5652cbaacbe2f1a80dec7cb0e35313369550f82e36f41b6e940987
4
- data.tar.gz: 2ce309abaaad66688d56242772201ee77ac291a4c5c9a24dc1418ab09b6cef0c
3
+ metadata.gz: 7531850cba319c703685684605433173f6b55d2d39df481c65492772fe31bc86
4
+ data.tar.gz: 61cbee634cd9292024ca7f126f867abbe9b8f9e6087c90f75ea18e87991cd4f2
5
5
  SHA512:
6
- metadata.gz: f60723b8732063ebf4593fe044d5777994ecf15be6437f39dad65a614dc7ddbdd7d9236889d618feca8ee116caf86db523457ac98b9093d37aad4a5acfd5f011
7
- data.tar.gz: a00d9460d8f5c68ea6d587ce3c54644deae4ff365339afe9cd4df32b007ee3f4304ff7afe769f33b319328ca32fa69147ca74670b1db117f2d9f8459695f17e9
6
+ metadata.gz: 98abb79648eec38f9b035138e664f251b10530d7b1f38e70f6307749a224fc8237a8a4217be9a8792b4593a8938e199d760ff3b5d73a340cb91c8b3ffb63ba70
7
+ data.tar.gz: 7b691f28627be2337780cadd32d4212f9dfe13b5d4c2493ee8720ce7e9d80c28135e96257f46527c10c3924fd8474bd23f0da84558f76060e5a15ab924507c08
data/CHANGELOG.md ADDED
@@ -0,0 +1,877 @@
1
+ # main
2
+
3
+ # [0.9.34] - April 12nd, 2023
4
+
5
+ [0.9.34]: https://github.com/lsegal/yard/compare/v0.9.33...v0.9.34
6
+
7
+ - Add changelog to yard.gemspec
8
+ - Fix fork behavior in `yard server --fork`
9
+
10
+ # [0.9.33] - April 11st, 2023
11
+
12
+ [0.9.33]: https://github.com/lsegal/yard/compare/v0.9.32...v0.9.33
13
+
14
+ - Ensure .yardopts is present in gem package (internal YARD documentation change)
15
+
16
+ # 0.9.32 - April 9th, 2023
17
+
18
+ [0.9.32]: https://github.com/lsegal/yard/compare/v0.9.31...v0.9.32
19
+
20
+ - Fix issue with custom Rack::Request attributes in `yard server`
21
+
22
+ # [0.9.31] - April 9th, 2023
23
+
24
+ [0.9.31]: https://github.com/lsegal/yard/compare/v0.9.30...v0.9.31
25
+
26
+ - Remove dependency on webrick in YARD::Server::Commands::StaticFileHelpers
27
+
28
+ # [0.9.30] - April 9th, 2023
29
+
30
+ [0.9.30]: https://github.com/lsegal/yard/compare/v0.9.29...v0.9.30
31
+
32
+ - Hot release fix to correct issue with gem packaging missing templates (#1490)
33
+
34
+ # [0.9.29] - April 8th, 2023
35
+
36
+ [0.9.29]: https://github.com/lsegal/yard/compare/v0.9.28...v0.9.29
37
+
38
+ - Enable table support for CommonMarker (#1443)
39
+ - Parser performance improvements (#1452, #1453, #1454, #1455)
40
+ - Fix autoload of RipperParser (#1460)
41
+ - Remove dependency on webrick for better Ruby 3.1+ support
42
+ - Improvements for mixin resolution (#1467, #1468)
43
+
44
+ # [0.9.28] - June 1st, 2022
45
+
46
+ [0.9.28]: https://github.com/lsegal/yard/compare/v0.9.27...v0.9.28
47
+
48
+ - Safe load config YAML files (#1385)
49
+ - Handle empty string constants (#1415)
50
+ - Pre-emptively support removal of `Object#taint` in Ruby 3.2 (#1419)
51
+ - Fix Ruby 3.1 forward args Ripper change (#1431)
52
+
53
+ # [0.9.27] - November 29th, 2021
54
+
55
+ [0.9.27]: https://github.com/lsegal/yard/compare/v0.9.26...v0.9.27
56
+
57
+ - Add support for Ruby 3.0 endless method definitions. (#1376, #1381)
58
+ - Add existence check for README file (#1367)
59
+ - Support module_function decorator (#1365)
60
+ - Add CommonMarker markup support (`-m commonmarker`) (#1157, #1388)
61
+ - Fix nested array parsing (#1389)
62
+ - Add WEBrick as a runtime dependency for Ruby 3.0 support (#1400)
63
+ - Support `fail_on_warning` option in `yard stats` command (#1392)
64
+ - Better integration with Sorbet (#1401)
65
+ - Handle include mixins on complex paths (#1386)
66
+ - Fix `@!scope` maintaining state in lone comment blocks (#1411)
67
+ - Remove support for Travis CI
68
+
69
+ # [0.9.26] - December 26th, 2020
70
+
71
+ [0.9.26]: https://github.com/lsegal/yard/compare/v0.9.25...v0.9.26
72
+
73
+ - Add support for Ruby 3.0 and fix tests
74
+ - Fix support for `frozen_string_literal: false` magic comments (#1363)
75
+
76
+ # [0.9.25] - May 3rd, 2020
77
+
78
+ [0.9.25]: https://github.com/lsegal/yard/compare/v0.9.24...v0.9.25
79
+
80
+ - Fix parsing issue with conditional blocks mixed with conditional modifiers.
81
+ (#1308, #1324, #1326, #1327)
82
+ - Add table of contents IDs to redcarpet generated markdown. (#1323)
83
+ - Backport fixes for Ruby 1.9 (#1320)
84
+ - Fix parsing of checksums in yard server (#1301)
85
+ - Map Ruby C variable error names to Ruby classes (#1270, #1275)
86
+ - Fix initialization of RDocMarkup across threads (#1318)
87
+ - Remove warning for Kernel#open (#1312)
88
+ - Omit spec files in gem package (#1307)
89
+ - README updates (#1322)
90
+
91
+ # [0.9.24] - January 8th, 2020
92
+
93
+ [0.9.24]: https://github.com/lsegal/yard/compare/v0.9.23...v0.9.24
94
+
95
+ - Add {YARD::CodeObjects::NamespaceMapper.on_invalidate} callback when separator
96
+ cache is changed.
97
+ - Fix issue where Registry fails to resolve first-time lookups on instance methods.
98
+
99
+ # [0.9.23] - January 5th, 2020
100
+
101
+ [0.9.23]: https://github.com/lsegal/yard/compare/v0.9.22...v0.9.23
102
+
103
+ - Fix issues with double encoded code blocks when highlighted from an extra
104
+ file.
105
+
106
+ # [0.9.22] - December 31st, 2019
107
+
108
+ [0.9.22]: https://github.com/lsegal/yard/compare/v0.9.21...v0.9.22
109
+
110
+ - Revert jquery update in last release since it requires more changes. (#1298)
111
+
112
+ # [0.9.21] - December 31st, 2019
113
+
114
+ [0.9.21]: https://github.com/lsegal/yard/compare/v0.9.20...v0.9.21
115
+
116
+ - Updates to add support for Ruby 2.7.0 (#1290, #1296)
117
+ - Fix parsing of multiline method signatures (#1220)
118
+ - Remove RubyGems post install message (#1269)
119
+ - Improve object deletion from RegistryStore (#1284)
120
+ - Improve memory usage performance (#1260)
121
+ - Handle include and extend calls with explicit receivers (#1274)
122
+ - Fix deep nesting of TOC items (#1288)
123
+ - Fix highlighting for Asciidoc markup code blocks (#1276)
124
+ - Fix HTML formatting of script tags (#1263)
125
+ - Update jquery to 3.4.1 (#1294)
126
+ - Test fixes (#1244)
127
+
128
+ # [0.9.20] - June 27th, 2019
129
+
130
+ [0.9.20]: https://github.com/lsegal/yard/compare/v0.9.19...v0.9.20
131
+
132
+ - Fix parsing of stringified Symbols in Ruby source (#1256).
133
+ - Fix path traversal vulnerability in `yard server`. This bug would allow
134
+ unsanitized HTTP requests to access arbitrary files on the machine of a
135
+ `yard server` host under certain conditions. Thanks to CuongMX from
136
+ Viettel Cyber Security for discovering this vulnerability.
137
+
138
+ # [0.9.19] - April 2nd, 2019
139
+
140
+ [0.9.19]: https://github.com/lsegal/yard/compare/v0.9.16...v0.9.19
141
+
142
+ - Fixed bug in browser back button (#1071, #1228)
143
+ - Fixed handling of ArgumentError in ExtraFileObject (#1198)
144
+ - Fixed double return tag displaying on boolean methods (#1226)
145
+ - Removed unused `Module#namespace_name` function (#1229)
146
+ - Fixed parsing order of README files. YARD will now prefer README over
147
+ README.md over README.x.md or README-x.md (and the like). READMEs will now
148
+ also be ordered by filename; the first README is still chosen unless
149
+ `--readme` is provided.
150
+ - Updated AsciiDoc markup support to use non-deprecated calls.
151
+
152
+ # [0.9.16] - August 11th, 2018
153
+
154
+ [0.9.16]: https://github.com/lsegal/yard/compare/v0.9.15...v0.9.16
155
+
156
+ - Documentation fixes (#1175, #1178).
157
+ - Fixed stack overflow issue when parsing extremely large lists (#1176).
158
+
159
+ # [0.9.15] - July 17th, 2018
160
+
161
+ [0.9.15]: https://github.com/lsegal/yard/compare/v0.9.14...v0.9.15
162
+
163
+ - Fixed security issue in parsing of Ruby code that could allow for arbitrary
164
+ execution. Credit to Nelson Elhage <nelhage@nelhage.com> for discovering this
165
+ issue.
166
+
167
+ # [0.9.14] - June 2nd, 2018
168
+
169
+ [0.9.14]: https://github.com/lsegal/yard/compare/v0.9.13...v0.9.14
170
+
171
+ - Fixed a regression in symbol parsing (#1170).
172
+
173
+ # [0.9.13] - May 28th, 2018
174
+
175
+ [0.9.13]: https://github.com/lsegal/yard/compare/v0.9.12...v0.9.13
176
+
177
+ - Added support for grouped constants via `@!group` directive (#1056).
178
+ - Added support for quoted symbols (#1168).
179
+ - Added support for i18n in tag text (#1169).
180
+ - Fixed HTML rendering of inline code blocks (#1152).
181
+ - Fixed rendering of anchor URLs in rendered HTML (#1154).
182
+
183
+ # [0.9.12] - November 26th, 2017
184
+
185
+ [0.9.12]: https://github.com/lsegal/yard/compare/v0.9.11...v0.9.12
186
+
187
+ - Be more explicit about lack of support for absolute paths in extra files
188
+ specified by `yard doc` command.
189
+
190
+ # [0.9.11] - November 23rd, 2017
191
+
192
+ [0.9.11]: https://github.com/lsegal/yard/compare/v0.9.10...v0.9.11
193
+
194
+ - Fixed security issue in `--readme` that allowed for arbitrary file reads on
195
+ disk. Credit to ztz <ztz@ztz.me> for discovering this issue.
196
+ - Improved styling for inline code blocks (#1142).
197
+
198
+ # [0.9.10] - November 18th, 2017
199
+
200
+ [0.9.10]: https://github.com/lsegal/yard/compare/v0.9.9...v0.9.10
201
+
202
+ - Added `--fail-on-warning` option for `yard doc` which exits with a non-zero
203
+ code if there are any warnings (#1093).
204
+ - Added support for parsing inside `Struct.new` blocks (#1099).
205
+ - Added support new ripper AST tokens (#1104, #1124).
206
+ - Fixed an issue where `@see (obj)` reference tags would fail (#1111)
207
+ - Fix sorting in `yard stats` (#1123).
208
+
209
+ # [0.9.9] - April 23rd, 2017
210
+
211
+ [0.9.9]: https://github.com/lsegal/yard/compare/v0.9.8...v0.9.9
212
+
213
+ - Added `gem uninstall` hooks to remove YARD documentation files. (#1083)
214
+ - Added support for C++ namespaces. (#809)
215
+ - Fixed issue where loading a .html page via an anchor would not scroll to
216
+ the anchor section. (#1082)
217
+ - Hide some Ruby warnings.
218
+ - Improve progress indicator icons in terminal.
219
+
220
+ # [0.9.8] - January 13th, 2017
221
+
222
+ [0.9.8]: https://github.com/lsegal/yard/compare/v0.9.7...v0.9.8
223
+
224
+ - Fixed installed gems not being correctly found in `yard server` and by plugins.
225
+ - Fixed tokenization of `%w(...)` array syntax.
226
+
227
+ # [0.9.7] - January 9th, 2017
228
+
229
+ [0.9.7]: https://github.com/lsegal/yard/compare/v0.9.6...v0.9.7
230
+
231
+ - Fixed resolution of absolute object paths with ambiguous names. (#1029)
232
+
233
+ # [0.9.6] - January 7th, 2017
234
+
235
+ [0.9.6]: https://github.com/lsegal/yard/compare/v0.9.5...v0.9.6
236
+
237
+ - Removed official support for Ruby 1.x (1.8/1.9). YARD can still be installed
238
+ in these versions, but support is not guaranteed. Simple bug fixes may still
239
+ be considered via pull request only. Issues without code will be automatically
240
+ closed.
241
+ - Added {YARD::Tags::Tag#explain_types} returning a plain English summary
242
+ of the type specification of a given tag. Also adds {YARD::Tags::TypesExplainer}
243
+ as an implementation class for the method.
244
+ - Added support for automatic linking of constants and method calls of
245
+ Ruby syntax highlighted source code in generated HTML. Also adds the
246
+ {YARD::Parser::Ruby::TokenResolver} implementation class to iterate over
247
+ tokenized code with extra resolved object information.
248
+ - Added support for compound constant assignments (`A::B::C = true`).
249
+ - Added `LibraryVersion#yardoc_file_for_SOURCE` callback method for sources with
250
+ a pre-determined yardoc file location. Implement this method instead of
251
+ manually setting `library.yardoc_file = ...` in your load method (you can
252
+ still assign the attribute manually).
253
+ - Use RubyGems 2.x+ API to query gems when available instead of using backport.
254
+ - Various bug fixes
255
+
256
+ # [0.9.5] - July 22nd, 2016
257
+
258
+ [0.9.5]: https://github.com/lsegal/yard/compare/v0.9.4...v0.9.5
259
+
260
+ - `yard doc` will now generate `.yardoc/processing` and `.yardoc/complete` files
261
+ to allow other tools to properly detect when YARD is in the middle of parsing
262
+ source files, and when it has completed writing the database.
263
+ - Added support for on-demand generation of LibraryVersion objects using the
264
+ `:disk` source type. LibraryVersion objects pointing to a .yardoc database
265
+ directory will now auto-generate if there is a `source_path` attached.
266
+ - Added warning for macros attached to non-method objects.
267
+ - Fixed a few more parsing errors.
268
+
269
+ # [0.9.4] - July 21st, 2016
270
+
271
+ [0.9.4]: https://github.com/lsegal/yard/compare/v0.9.3...v0.9.4
272
+
273
+ - Minor Ruby file parsing and CSS bug fixes.
274
+
275
+ # [0.9.3] - July 20th, 2016
276
+
277
+ [0.9.3]: https://github.com/lsegal/yard/compare/v0.9.2...v0.9.3
278
+
279
+ - Added support for {YARD::Server::RackAdapter} to be mounted under prefix URIs.
280
+ - Fixed regression in `yard server -g` that caused static file assets on index
281
+ page to return 404 errors.
282
+ - Fixed regression in `yard server -g` index page that disabled scrolling and
283
+ caused other HTML rendering glitches.
284
+
285
+ # [0.9.2] - July 19th, 2016
286
+
287
+ [0.9.2]: https://github.com/lsegal/yard/compare/v0.9.1...v0.9.2
288
+
289
+ - Added `yard config --gem-install-[yri|yard]` commands which auto-configure
290
+ your `~/.gemrc` file to run yri/yard instead of ri/rdoc on a `gem install`.
291
+ - Added support for gemspec metadata key `"yard.run"`, which can be either
292
+ `"yard"` or `"yri"` to run the respective commands on a `gem install`.
293
+ - Added `yard doc --no-progress` to hide the progress bar.
294
+ - Fix resolution error for compound proxy namespaces.
295
+ - YRI will now search across all gem versions (latest first) for the .yardoc
296
+ database.
297
+
298
+ # [0.9.1] - July 18th, 2016
299
+
300
+ [0.9.1]: https://github.com/lsegal/yard/compare/v0.9.0...v0.9.1
301
+
302
+ - Added "Attributes" section to `yard stats`.
303
+ - Added support for RubyGems 2.x `--document=yri,yard` flags. You can now run
304
+ YARD documentation generation against installed gems by running:
305
+ `gem install mygem --document=yard,yri`.
306
+ - Added `/static/*` routing for library-specific routing. This enables static
307
+ template files to be served on a per-library basis instead of globally shared
308
+ across the `yard server`.
309
+ - Added support for inlining of `{include:*}` syntax. Using this syntax in
310
+ the middle of a docstring paragraph will no longer create a separate paragraph
311
+ for the included text.
312
+ - Added support for resolving `{}` syntax in text templates, specifically for
313
+ use in `{include:*}` syntax.
314
+ - Improved object resolution logic in `{Foo::Bar}` syntax and {YARD::Registry.resolve}.
315
+ New resolution logic should now more accurately support resolving compound paths
316
+ across namespaces and through the inheritance tree (as Ruby does).
317
+ - The `frozen_string_literal: true` comment line in Ruby source files will now be
318
+ excluded from docstrings.
319
+ - Added a workaround for https://bugs.ruby-lang.org/issues/11485
320
+ - Fixed an issue where type using a docstring reference on an `@!attribute` macro
321
+ would be incorrectly parsed as a type specifier. This change updates the tag
322
+ parser to disallow newlines between the tag name and opening bracket of the
323
+ type specification.
324
+ - Fixed an issue where `--embed-mixins` would improperly embed methods from
325
+ inherited classes instead of modules.
326
+ - Fixed various parsing errors and YARD exceptions.
327
+ - Added a warning for modules or classes being redefined as constants.
328
+ - Reverted stripping of HTML in {YARD::Docstring#summary}.
329
+ - Added optimization to remove initial docstring parse on newly created code objects.
330
+ - {YARD::CodeObjects::Base#format} now passes the :type parameter to templates.
331
+ - Hide methods with filtered namespaces in Method Listing.
332
+
333
+ # [0.9.0] - July 4th, 2016
334
+
335
+ [0.9.0]: https://github.com/lsegal/yard/compare/v0.8.7.6...v0.9.0
336
+
337
+ Special thanks to Alex Dowad, MSP-Greg, and Alex McLain for their extended
338
+ contributions to this version.
339
+
340
+ - (Breaking Change): Replaced default template with an updated "frameless" version.
341
+ This change may affect backward compatibility if custom templates made modifications
342
+ to `default/fulldoc/html`, specifically the index or navigation lists.
343
+ - Added support for Ruby 2.1+ decorator style method declaration syntax. YARD now
344
+ supports:
345
+ private def foo(x, y) end
346
+ - Metadata headers in extra files can now be escaped from rendering by enclosing them
347
+ in HTML comment blocks (`<!--\n @metadata here... \n-->`). Ensure that the opening
348
+ comment tag is alone on the first line of the file to use this functionality.
349
+ - Improved parsing of various CRuby coding styles.
350
+ - Fixed issue with binary image assets when using `yard server`.
351
+ - Fixed deprecation warnings from Rake 10.x.
352
+ - Tests updated for RSpec 3.
353
+
354
+ # [0.8.7.6] - October 26, 2014
355
+
356
+ [0.8.7.6]: https://github.com/lsegal/yard/compare/v0.8.7.5...v0.8.7.6
357
+
358
+ - Support using `@option` tag on keyword arg splat parameter. (#729)
359
+ - Add `.stats_options` for `YardocTask`. (#800, #801)
360
+
361
+ # [0.8.7.5] - October 26, 2014
362
+
363
+ [0.8.7.5]: https://github.com/lsegal/yard/compare/v0.8.7.4...v0.8.7.5
364
+
365
+ - Fix linking of methods in top level namespace in method listing. (#776)
366
+ - Support using C macros in function declarations. (#810)
367
+ - YARD will no longer group comment blocks starting on the same column if they
368
+ are preceded by code. (#798)
369
+ - Handle anonymous lambda calls in toplevel scope. (#774)
370
+ - Support I18n in `@overload` tags. (#794)
371
+ - Support `yard stats` for objects with no file property. (#792)
372
+ - Support for named arguments in Ruby >= 2.1. (#785)
373
+ - Exclude README backup files from YARD generation. (#790)
374
+ - Turned on the lax spacing option in Redcarpet to comply with the
375
+ Markdown standard.
376
+ - Escape HTML in YARD server search placeholder template.
377
+ - Fix issue with `private_class_method` support. (#760, #767)
378
+ - Enable tables support by default in Redcarpet Markdown provider. (#765)
379
+
380
+ # 0.8.7.4 - March 22, 2014
381
+
382
+ [0.8.7.4]: https://github.com/lsegal/yard/compare/v0.8.7.3...v0.8.7.4
383
+
384
+ - Mark C methods as explicit but also remove explicit check in stats. (#727)
385
+ - Report unresolved parent namespaces as undocumentable errors instead. (#753)
386
+ - No longer ignore overridden methods from documentation check in stats (#719)
387
+ - Fix JRuby throwing exception when remove_method called on non-existent method. (#732)
388
+ - Add basic support for `private_class_method` (#747)
389
+ - Ensure namespace is always set when parent module is not found. (#753)
390
+ - Set overflow as auto on table of contents.
391
+ - Report 100% documented if nothing is undocumented. (#754)
392
+ - Added support for RubyGems 2.0.0+. (#742)
393
+ - Allow users to enter their own YARD RakeTask name. (#705)
394
+ - Fixed a typo that was causing Windows detection to always fail. (#715)
395
+ - Add debug information when loading a plugin fails. (#711)
396
+
397
+ # [0.8.7.3] - November 1, 2013
398
+
399
+ [0.8.7.3]: https://github.com/lsegal/yard/compare/v0.8.7.2...v0.8.7.3
400
+
401
+ - Handle Unicode method/class/file names in server URL encoding (lsegal/rubydoc.info#69).
402
+ - Style keyword style hashes with same symbol color in code highlighting (#707).
403
+ - Fix broken JS when visiting docs in file:// scheme (#706).
404
+ - Add support for new AsciiDoc file extensions (#704).
405
+ - Fix issues where non-Ruby code blocks would not display in Ruby 2 (#702).
406
+ - Add support for extra Ruby 2 symbol types in Ripper (#701).
407
+ - Ensure config directory exists before saving config file (#700).
408
+
409
+ # [0.8.7.2] - September 18, 2013
410
+
411
+ [0.8.7.2]: https://github.com/lsegal/yard/compare/v0.8.7.1...v0.8.7.2
412
+
413
+ - Disallow absolute URLs when using frame anchor support.
414
+ - Support casted functions in CRuby method declarations (#697)
415
+
416
+ # [0.8.7.1] - September 11, 2013
417
+
418
+ [0.8.7.1]: https://github.com/lsegal/yard/compare/v0.8.7...v0.8.7.1
419
+
420
+ - Fix potential XSS issue with frame anchor support.
421
+ - Add support for gettext 3.x gem.
422
+
423
+ # [0.8.7] - July 26, 2013
424
+
425
+ [0.8.7]: https://github.com/lsegal/yard/compare/v0.8.6.2...v0.8.7
426
+
427
+ - Added `--hide-api API` option to hide objects with a given `@api` tag (#685).
428
+ - Added "Returns ...." prefix to summary when a lone @return tag is used.
429
+ - Fixed issue that caused ref tags to be added to a docstring twice (#678).
430
+ - Fixed formatting issue in docstring summaries (#686)
431
+
432
+ # [0.8.6.2] - June 27, 2013
433
+
434
+ [0.8.6.2]: https://github.com/lsegal/yard/compare/v0.8.6.1...v0.8.6.2
435
+
436
+ - Fixed issue where `yard graph` was not displaying methods
437
+
438
+ # [0.8.6.1] - April 14, 2013
439
+
440
+ [0.8.6.1]: https://github.com/lsegal/yard/compare/v0.8.6...v0.8.6.1
441
+
442
+ - Fixed broken links in File menu on default HTML template
443
+ - Added --layout switch to `yard display` to wrap output in layout template.
444
+ - See {file:docs/WhatsNew.md} for more information on added features.
445
+
446
+ # [0.8.6] - April 13, 2013
447
+
448
+ [0.8.6]: https://github.com/lsegal/yard/compare/v0.8.5.2...v0.8.6
449
+
450
+ - Various fixes and improved Ruby 2.x compatibility support
451
+ - Added support for `asciidoc` markup type
452
+ - Added `yard markups` command to list available markup types
453
+ - Added `yard display` command to display and format an individual object
454
+ - See {file:docs/WhatsNew.md} for more information on added features.
455
+
456
+ # [0.8.5.2] - February 26, 2013
457
+
458
+ [0.8.5.2]: https://github.com/lsegal/yard/compare/v0.8.5.1...v0.8.5.2
459
+
460
+ - Support new keyword argument syntax in method signatures (Ruby 2.x)
461
+
462
+ # [0.8.5.1] - February 25, 2013
463
+
464
+ [0.8.5.1]: https://github.com/lsegal/yard/compare/v0.8.5...v0.8.5.1
465
+
466
+ - Fix `yard diff` of gem files with RubyGems 2.x
467
+
468
+ # [0.8.5] - February 24, 2013
469
+
470
+ [0.8.5]: https://github.com/lsegal/yard/compare/v0.8.4.1...v0.8.5
471
+
472
+ - Basic support for Ruby 2.0 (fix compat issues in RDoc 4.0, RubyGems 2.0)
473
+ - Add CSS styling for tables in default HTML template
474
+
475
+ # [0.8.4.1] - February 5, 2013
476
+
477
+ [0.8.4.1]: https://github.com/lsegal/yard/compare/v0.8.4...v0.8.4.1
478
+
479
+ - Fix regression that broke loading of existing yardoc dbs (#648)
480
+
481
+ # [0.8.4] - February 4, 2013
482
+
483
+ [0.8.4]: https://github.com/lsegal/yard/compare/v0.8.3...v0.8.4
484
+
485
+ - Add `-B/--bind` switch to yard server (#593, #608)
486
+ - Add CodeObjects::Base#title for plugins to customize how object
487
+ links display (#646)
488
+ - Disable linking objects filtered out by verifiers (#645)
489
+ - Allow macro expansion on class methods (#632)
490
+ - Expand newly attached macro on first DSL method call (#631)
491
+ - Disable RubyGems plugin in Ruby 2.0 (#627)
492
+ - Fix line range for class/module node bodies (#626)
493
+ - Search extended modules for attached DSL macros (#553)
494
+
495
+ # [0.8.3] - October 14, 2012
496
+
497
+ [0.8.3]: https://github.com/lsegal/yard/compare/v0.8.2.1...v0.8.3
498
+
499
+ - Add `--non-transitive-tag` to disable tag transitivity (#571)
500
+ - Support --db inside .yardopts for graph/server commands (#583, #586)
501
+ - Fix handling for =begin/=end docstrings (#577, #578)
502
+ - Parser only sorts file lists when a glob is provided (#572)
503
+ - Fix formatting in `{include:Object#method}` syntax (#569)
504
+ - Fix @option tag inside of module functions (#563)
505
+ - Fix to `--api` and `--no-api` support (#559)
506
+ - Fix class nesting issues when path starts with "::" (#552)
507
+
508
+ # [0.8.2.1] - June 9, 2012
509
+
510
+ [0.8.2.1]: https://github.com/lsegal/yard/compare/v0.8.2...v0.8.2.1
511
+
512
+ - Fix a set of regressions in yard server search and dynamic generation
513
+
514
+ # [0.8.2] - June 7, 2012
515
+
516
+ [0.8.2]: https://github.com/lsegal/yard/compare/v0.8.1...v0.8.2
517
+
518
+ - Added progress style output in tty terminals
519
+ - Embedded mixins should ignore methods defined on module (#539)
520
+ - Fixed permalinks for embedded mixins in `yard server` (#540)
521
+ - Improve parsing in CRuby code (#543)
522
+ - Ensure Registry.resolve picks module when parsing mixins (#545)
523
+ - Fixed regression that caused various commands to not show output (#548)
524
+ - Respect current visibility when parsing class conditions (#551)
525
+
526
+ # [0.8.1] - May 2, 2012
527
+
528
+ [0.8.1]: https://github.com/lsegal/yard/compare/v0.8.0...v0.8.1
529
+
530
+ - Added `--[no-]api` switch to generate docs for API sets (see {file:docs/WhatsNew.md} for details) (#532)
531
+ - The `yard list` command now uses cache by default (#533)
532
+ - Fix `yardoc` generating incorrectly named method list file (#528)
533
+ - Fix HTML output occasionally showing trailing mdash on options list (#522)
534
+
535
+ # [0.8.0] - April 30, 2012
536
+
537
+ [0.8.0]: https://github.com/lsegal/yard/compare/v0.7.5...v0.8.0
538
+
539
+ - See {file:docs/WhatsNew.md} for a list of added features
540
+ - Over 20 bug fixes:
541
+ - Properly filter hidden setter/getter attributes (#394)
542
+ - Fix test failures in Linux environments (#397, #472, #473, #512, #513)
543
+ - Fix attribute inheritance and @private (#432)
544
+ - Fix attribute parsing (#435)
545
+ - Allow aliases for attributes (#436)
546
+ - Fix namespace fetching in `handle_alias()` (#437)
547
+ - Fix overwritten attributes marked as inherited (#442)
548
+ - Fix documenting constants defined from C code with `rb_define_const()` (#443)
549
+ - Do not escape snippets twice (#445)
550
+ - Ajax method/class search should not fire when a non-printable character is pressed (#446)
551
+ - Fix yard server crashing when RDoc is not installed (#456)
552
+ - Fix tags ignored when `(see #foo)` is used (#457)
553
+ - Fix three "Returns" for two `@overload` tags (#458)
554
+ - Do not auto-detect DSL methods as method objects if parameter name is not a valid method name (#464)
555
+ - Fix attaching of macros to Object (#465)
556
+ - Fix handling of `%w()` source in `[]/[]=` parsed context. (#461, pull in #468)
557
+ - Don't add default `@return` if `@overload` has `@return`. (#458, pull in #469)
558
+ - Don't discard tags by (see ...). (#457, pull in #470)
559
+ - Fix constants listed as inherited when overwritten (#474)
560
+ - Fix `yardoc --asset` behaving differently on first and subsequent calls. (#477)
561
+ - `!!!lang` code blocks should set the lang in `<pre>`'s class. (#478, #479)
562
+ - Fix "File List" search tab error. (#502)
563
+ - Fix search bar not redirecting to method page. (#509)
564
+ - Fix server returning exception message bodies as String (#518)
565
+
566
+ # [0.7.5] - January 31, 2012
567
+
568
+ [0.7.5]: https://github.com/lsegal/yard/compare/v0.7.4...v0.7.5
569
+
570
+ - Various minor bug fixes
571
+
572
+ # [0.7.4] - December 2, 2011
573
+
574
+ [0.7.4]: https://github.com/lsegal/yard/compare/v0.7.3...v0.7.4
575
+
576
+ - Redcarpet is now the default Markdown formatting library. GFM now works out-of-box (#404)
577
+ - Fix server side searching for elements that are marked private (#420)
578
+ - Add 'textile_strict' and 'pre' markup types, reorganize text and none (#416)
579
+ - Improve encoding line detection (#415)
580
+ - Add support for `rb_define_alias` in CRuby code (#413)
581
+ - Fix rendering of some keywords in source view (#410)
582
+ - Add support for RDoc 3.10+ (#406, #407)
583
+ - Fix typewriter text being processed in code blocks (#403)
584
+ - Improve support for has_rdoc in RubyGems 1.8.x (#401)
585
+ - See the {file:docs/WhatsNew.md} document for details on added features
586
+
587
+ # [0.7.3] - October 15, 2011
588
+
589
+ [0.7.3]: https://github.com/lsegal/yard/compare/v0.7.2...v0.7.3
590
+
591
+ - Improve support for parsing under Ruby 1.9.2p290 and 1.9.3 (#365, #370)
592
+ - Add support for SWIG generated CRuby code (#369)
593
+ - Add support for `rb_define_attr` calls in CRuby code (#362)
594
+ - Handle file pointers in CRuby code (#358)
595
+
596
+ # [0.7.2] - June 14, 2011
597
+
598
+ [0.7.2]: https://github.com/lsegal/yard/compare/v0.7.1...v0.7.2
599
+
600
+ - Fix `yard --help` not showing proper output
601
+ - YARD now expands path to `.yardoc` file in daemon mode for server (#328)
602
+ - Fix `@overload` tag linking to wrong method (#330)
603
+ - Fix incorrect return type when using `@macro` (#334)
604
+ - YARD now requires 'thread' to support RubyGems 1.7+ (#338)
605
+ - Fix bug in constant documentation when using `%w()` (#348)
606
+ - Fix YARD style URL links when using autolinking markdown (#353)
607
+
608
+ # [0.7.1] - May 18, 2011
609
+
610
+ [0.7.1]: https://github.com/lsegal/yard/compare/v0.7.0...v0.7.1
611
+
612
+ - Fixes a bug in `yard server` not displaying class list properly.
613
+
614
+ # [0.7.0] - May 17, 2011
615
+
616
+ [0.7.0]: https://github.com/lsegal/yard/compare/v0.6.8...v0.7.0
617
+
618
+ - See the {file:docs/WhatsNew.md} document for details on added features
619
+ - Make sure that Docstring#line_range is filled when possible (#243)
620
+ - Set #verifier in YardocTask (#282)
621
+ - Parse BOM in UTF-8 files (#288)
622
+ - Fix instance attributes not showing up in method list (#302)
623
+ - Fix rendering of %w() literals in constants (#306)
624
+ - Ignore keyboard shortcuts when an input is active (#312)
625
+ - And more...
626
+
627
+ # [0.6.8] - April 14, 2011
628
+
629
+ [0.6.8]: https://github.com/lsegal/yard/compare/v0.6.7...v0.6.8
630
+
631
+ - Fix regression in RDoc 1.x markup loading
632
+ - Fix regression in loading of markup libraries for `yard server`
633
+
634
+ # [0.6.7] - April 6, 2011
635
+
636
+ [0.6.7]: https://github.com/lsegal/yard/compare/v0.6.6...v0.6.7
637
+
638
+ - Fix has_rdoc gem specification issue with new RubyGems plugin API (oops!)
639
+
640
+ # [0.6.6] - April 6, 2011
641
+
642
+ [0.6.6]: https://github.com/lsegal/yard/compare/v0.6.5...v0.6.6
643
+
644
+ - Fix error message when RDoc is not present (#270)
645
+ - Add markup type 'none' to perform basic HTML translation (fallback when RDoc is not present)
646
+ - Add support for RubyGems 1.7.x (#272)
647
+ - Fix rendering of `{url description}` syntax when description contains newline
648
+
649
+ # [0.6.5] - March 13, 2011
650
+
651
+ [0.6.5]: https://github.com/lsegal/yard/compare/v0.6.4...v0.6.5
652
+
653
+ - Support `ripper` gem in Ruby 1.8.7
654
+ - Upgrade jQuery to 1.5.1
655
+ - Fix handling of alias statements with quoted symbols (#262)
656
+ - Add CSS styles (#260)
657
+ - Unhandled exception in YARD::Handlers::Ruby::MixinHandler indexing documentation for eventmachine (#248)
658
+ - Splice any alias references on method re-definitions into separate methods (#247)
659
+ - Fix "yard graph" (#245)
660
+ - Don't process ++ typewriter text inside of HTML attributes (#244)
661
+ - Prioritize loading of Kramdown before Maruku (#241)
662
+ - Skip shebang encoding in docstrings (#238)
663
+ - Fix truncation of references in @deprecated (#232)
664
+ - Show @api private note when no other tags are present (#231)
665
+ - Detect docstrings starting with "##" as `Docstring#hash_flag` (#230)
666
+ - Remove trailing whitespace from freeform tags (#229)
667
+ - Fix line through for deprecated methods (#225)
668
+ - Mistake in Tags.md (#223)
669
+ - Improve database storage by being more efficient with filesystem usage (#222)
670
+ - Make Registry thread local (#221)
671
+ - Support `private_constant` class method for 1.9.3 (#219)
672
+ - Do not assume RDoc is installed (#214)
673
+
674
+ # [0.6.4] - December 21, 2010
675
+
676
+ [0.6.4]: https://github.com/lsegal/yard/compare/v0.6.3...v0.6.4
677
+
678
+ - Fix yri tool crashing with new Config class (gh-217)
679
+ - Fix support for ::TopLevelConstants (gh-216)
680
+ - YARD's test suite is now RSpec2 compatible (gh-215)
681
+ - Improved documentation for YARD::Server features (gh-207)
682
+ - Fix displaying of collaped method summary lists (gh-204)
683
+ - Fix automatic loading of markup providers (gh-206)
684
+ - Fix keyboard shortcuts for Chrome (gh-203)
685
+ - Disallow `extend self` inside of a class (gh-202)
686
+ - Constants now recognized in C extensions (gh-201)
687
+
688
+ # [0.6.3] - November 21, 2010
689
+
690
+ [0.6.3]: https://github.com/lsegal/yard/compare/v0.6.2...v0.6.3
691
+
692
+ - Fixed regression that caused `yardoc --markup` to silently exit
693
+
694
+ # [0.6.2] - November 15, 2010
695
+
696
+ [0.6.2]: https://github.com/lsegal/yard/compare/v0.6.1...v0.6.2
697
+
698
+ - **Plugins no longer automatically load, use `--plugin` to load a plugin**
699
+ - Added YARD::Config and ~/.yard/config YAML configuration file
700
+ - Added `yard config` command to view/edit YARD configuration file
701
+ - Fixes for YARD in 1.8.6 (gh-178)
702
+ - Various HTML template adjustments and fixes (gh-198,199,200)
703
+ - Improved `yard server -m` multi-project stability (gh-193)
704
+ - Fixed handling of `yardoc --no-private` with missing class definitions (gh-197)
705
+ - Added support for constants defined in C extensions (gh-177)
706
+ - Added support for Structs defined as "Klass = Struct.new(...)" (gh-187)
707
+ - Improved parsing support for third-party gems (gh-174,180)
708
+ - Improved support for JRuby 1.6.4+. YARD now passes all specs in JRuby (gh-185)
709
+ - Improved YARD documentation (gh-172,191,196)
710
+
711
+ # [0.6.1] - September 06, 2010
712
+
713
+ [0.6.1]: https://github.com/lsegal/yard/compare/v0.6.0...v0.6.1
714
+
715
+ - Fixed TOC showing on top of class/method list in no-frames view
716
+ - A message now displays when running `yard server` with Rack/Mongrel installed
717
+ - Improved performance of JS inline search for large class/method lists
718
+ - Improved link titles for relative object links
719
+ - Removed `String#camelcase` and `String#underscore` for better Rails compat.
720
+ - Fixed support for loading .yardoc files under Windows
721
+ - Fixed inheritance tree arrows not displaying in certain environments
722
+
723
+ # [0.6.0] - August 29, 2010
724
+
725
+ [0.6.0]: https://github.com/lsegal/yard/compare/v0.5.8...v0.6.0
726
+
727
+ - Added dynamic local documentation server
728
+ - Added @group/@endgroup declarations to organize methods into groups
729
+ - Added `yard` executable to serve as main CLI tool with pluggable commands
730
+ - Added `--asset` switch to `yardoc` to copy files/dirs to output dir
731
+ - Added ability to register/manipulate tags via CLI (`--tag`, etc.)
732
+ - Added `yard diff` command
733
+ - Added statistics to `yardoc` output (and `yard stats` command)
734
+ - Added Javascript generated Table of Contents to file pages
735
+ - Updated various APIs
736
+ - Removed `yard-graph` executable
737
+ - See more changes in the {file:docs/WhatsNew.md what's new document}
738
+
739
+ # [0.5.8] - June 22, 2010
740
+
741
+ [0.5.8]: https://github.com/lsegal/yard/compare/v0.5.7...v0.5.8
742
+
743
+ - Merge fix from 0.6 branch for --no-private visibility checking
744
+
745
+ # [0.5.7] - June 21, 2010
746
+
747
+ [0.5.7]: https://github.com/lsegal/yard/compare/v0.5.6...v0.5.7
748
+
749
+ - Fixed visibility flag parsing in `yardoc`
750
+ - Updated Parser Architecture documentation with new SourceParser API
751
+ - Improved Registry documentation for new load commands
752
+ - Fix loading of .yardoc file as cache (and preserving aliases)
753
+ - Fix "lib" directory missing when running YARD on installed gems
754
+
755
+ # [0.5.6] - June 12, 2010
756
+
757
+ [0.5.6]: https://github.com/lsegal/yard/compare/v0.5.5...v0.5.6
758
+
759
+ - Bug fixes for RubyGems plugin, `has_rdoc=false` should now work
760
+ - New API for registering custom parsers. See {file:docs/WhatsNew.md}
761
+
762
+ # [0.5.5] - May 22, 2010
763
+
764
+ [0.5.5]: https://github.com/lsegal/yard/compare/v0.5.4...v0.5.5
765
+
766
+ - Various bug fixes
767
+
768
+ # [0.5.4] - March 22, 2010
769
+
770
+ [0.5.4]: https://github.com/lsegal/yard/compare/v0.5.3...v0.5.4
771
+
772
+ - See {file:docs/WhatsNew.md what's new document} for changes
773
+
774
+ # [0.5.3] - January 11, 2010
775
+
776
+ [0.5.3]: https://github.com/lsegal/yard/compare/v0.5.2...v0.5.3
777
+
778
+ - See {file:docs/WhatsNew.md what's new document} for changes
779
+
780
+ # [0.5.2] - December 16, 2009
781
+
782
+ [0.5.2]: https://github.com/lsegal/yard/compare/v0.5.1...v0.5.2
783
+
784
+ - See {file:docs/WhatsNew.md what's new document} for changes
785
+
786
+ # [0.5.1] - December 15, 2009
787
+
788
+ [0.5.1]: https://github.com/lsegal/yard/compare/v0.5.0...v0.5.1
789
+
790
+ - See {file:docs/WhatsNew.md what's new document} for changes
791
+
792
+ # [0.5.0] - December 13, 2009
793
+
794
+ [0.5.0]: https://github.com/lsegal/yard/compare/v0.4.0...v0.5.0
795
+
796
+ - See {file:docs/WhatsNew.md what's new document} for changes
797
+
798
+ # [0.4.0] - November 15, 2009
799
+
800
+ [0.4.0]: https://github.com/lsegal/yard/compare/v0.2.3.5...v0.4.0
801
+
802
+ - Added new templating engine based on [tadpole](http://github.com/lsegal/tadpole)
803
+ - Added YARD queries (`--query` CLI argument to yardoc)
804
+ - Greatly expanded YARD documentation
805
+ - Added plugin support
806
+ - New `@abstract` and `@private` tags
807
+ - Changed default rake task to `rake yard`
808
+ - Read about changes in {file:docs/WhatsNew.md}
809
+
810
+ # [0.2.3.5] - August 13, 2009
811
+
812
+ [0.2.3.5]: https://github.com/lsegal/yard/compare/v0.2.3.4...v0.2.3.5
813
+
814
+ - Minor bug fixes.
815
+
816
+ # [0.2.3.4] - August 07, 2009
817
+
818
+ [0.2.3.4]: https://github.com/lsegal/yard/compare/v0.2.3.3...v0.2.3.4
819
+
820
+ - Minor bug fixes.
821
+
822
+ # [0.2.3.3] - July 26, 2009
823
+
824
+ [0.2.3.3]: https://github.com/lsegal/yard/compare/v0.2.3.2...v0.2.3.3
825
+
826
+ - Minor bug fixes.
827
+
828
+ # [0.2.3.2] - July 06, 2009
829
+
830
+ [0.2.3.2]: https://github.com/lsegal/yard/compare/v0.2.3.1...v0.2.3.2
831
+
832
+ - Fix Textile hard-break issues
833
+ - Add description for @see tag to use as link title in HTML docs.
834
+ - Add --title CLI option to specify a title for HTML doc files.
835
+ - Add custom.css file that can be overridden with various custom
836
+ styelsheet declarations. To use this, simply add `default/fulldoc/html/custom.css`
837
+ inside your code directory and use the `-t` template directory yardoc CLI
838
+ option to point to that template directory (the dir holding 'default').
839
+ - Add support in `yardoc` CLI to specify extra files (formerly --files)
840
+ by appending "- extra files here" after regular source files. Example:
841
+
842
+ yardoc --private lib/**/*.rb - FAQ LICENSE
843
+
844
+ # [0.2.3.1] - June 13, 2009
845
+
846
+ [0.2.3.1]: https://github.com/lsegal/yard/compare/v0.2.3...v0.2.3.1
847
+
848
+ - Add a RubyGems 1.3.2+ plugin to generate YARD documentation instead of
849
+ RDoc. To take advantage of this plugin, set `has_rdoc = 'yard'` in your
850
+ .gemspec file.
851
+
852
+ # [0.2.3] - June 07, 2009
853
+
854
+ [0.2.3]: https://github.com/lsegal/yard/compare/v0.2.2...v0.2.3
855
+
856
+ - See the {file:docs/WhatsNew.md} file for a list of important new features.
857
+
858
+ # [0.2.2] - Jun 16, 2008
859
+
860
+ [0.2.2]: https://github.com/lsegal/yard/compare/v0.2.1...v0.2.2
861
+
862
+ - This is the largest changset since yard's conception and involves a complete
863
+ overhaul of the parser and API to make it more robust and far easier to
864
+ extend and use for the developer.
865
+
866
+ # [0.2.1] - February 20, 2008
867
+
868
+ [0.2.1]: https://github.com/lsegal/yard/compare/v0.1a...v0.2.1
869
+
870
+ - See the {file:docs/WhatsNew.md} file for a list of important new features.
871
+
872
+ # 0.1a - February 24, 2007
873
+
874
+ - Released 0.1a experimental version for testing. The goal here is
875
+ to get people testing YARD on their code because there are too many possible
876
+ code styles to fit into a sane amount of test cases. It also demonstrates the
877
+ power of YARD and what to expect from the syntax (Yardoc style meta tags).
@@ -94,16 +94,16 @@ module YARD
94
94
  end
95
95
 
96
96
  def call_with_fork(request, &block)
97
- reader, writer = IO.pipe
97
+ IO.pipe(:binmode => true) do |reader, writer|
98
+ fork do
99
+ log.debug "[pid=#{Process.pid}] fork serving: #{request.path}"
100
+ reader.close
101
+ writer.print(Marshal.dump(call_without_fork(request, &block)))
102
+ end
98
103
 
99
- fork do
100
- log.debug "[pid=#{Process.pid}] fork serving: #{request.path}"
101
- reader.close
102
- writer.print(Marshal.dump(call_without_fork(request, &block)))
104
+ writer.close
105
+ Marshal.load(reader.read)
103
106
  end
104
-
105
- writer.close
106
- Marshal.load(reader.read)
107
107
  end
108
108
 
109
109
  def can_fork?
data/lib/yard/version.rb CHANGED
@@ -2,5 +2,5 @@
2
2
  # frozen_string_literal: true
3
3
 
4
4
  module YARD
5
- VERSION = '0.9.33'
5
+ VERSION = '0.9.34'
6
6
  end
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: yard
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.9.33
4
+ version: 0.9.34
5
5
  platform: ruby
6
6
  authors:
7
7
  - Loren Segal
@@ -26,6 +26,7 @@ files:
26
26
  - ".yardopts"
27
27
  - ".yardopts_guide"
28
28
  - ".yardopts_i18n"
29
+ - CHANGELOG.md
29
30
  - LEGAL
30
31
  - LICENSE
31
32
  - README.md