yard 0.9.33 → 0.9.34

Sign up to get free protection for your applications and to get access to all the features.

Potentially problematic release.


This version of yard might be problematic. Click here for more details.

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