search

lsegal / yard

YARD is a Ruby Documentation tool. The Y stands for "Yay!"
http://yardoc.org
MIT License
1.93k stars 397 forks source link

constant mapping (YARD::Parser::UndocumentableError) since v0.9.21 #1304

Closed glenfarclas17 closed 4 years ago

glenfarclas17 commented 4 years ago

(This is reposted from https://groups.google.com/forum/#!topic/yardoc/XVCBLAR0iZ0. ) Hello Yard Folks!

As of release v0.9.21, my project ruby-jss fails to generate the html docs, both locally and at rubydoc.info: https://www.rubydoc.info/gems/ruby-jss/

The full output of a local yard --verbose --debug -o /tmp/fixyard/ for version 0.9.24 is pasted below, with a backtrace at the bottom. It seems to match the error you see on rubydoc.info.

I know I always have lots of cleanup to do in my Yard formatting, but its always successfully created the html in the past.

Just now I removed and re-installed older versions of yard, and ran the same command for each until I found that v0.9.20 works without the error. 0.9.21-23 all failed in a similar way to 24.

I’d be happy to fix whatever’s causing this in my code, but the debug output doesn’t really help me locate the source of the problem. I could methodically work through all the warnings, that’ll take a time, and I won’t be able to get to that task for a while, so any pointers are welcome.

Let me know if I can provide more info.

Cheers & Thanks for providing such a useful tool to the Ruby community!

Steps to reproduce

Actual Output

------------ output of yard --verbose --debug -o /tmp/fixyard/ in v0.9.24

[debug]: Parsing ["{lib,app}/*/.rb", "ext/*/.{c,cc,cxx,cpp,rb}"] with ruby parser [debug]: Parsing lib/jss.rb [debug]: Parsing lib/jamf.rb [debug]: Parsing lib/jpapi.rb [debug]: Parsing lib/jss-api.rb [debug]: Parsing lib/ruby-jss.rb [debug]: Parsing lib/jss/client.rb [debug]: Parsing lib/jss/server.rb [debug]: Parsing lib/jamf/client.rb [debug]: Parsing lib/jss/utility.rb [warn]: @param tag has unknown parameter name: processor in file lib/jss/utility.rb' near line 129 [warn]: Unknown tag @seealso in filelib/jss/utility.rbnear line 280 [warn]: @param tag has unknown parameter name: Set in filelib/jss/utility.rb' near line 505 [debug]: Parsing lib/jss/version.rb [debug]: Parsing lib/jamf/utility.rb [warn]: @param tag has unknown parameter name: processor in file lib/jamf/utility.rb' near line 128 [warn]: Unknown tag @seealso in filelib/jamf/utility.rbnear line 274 [warn]: @param tag has unknown parameter name: Set in filelib/jamf/utility.rb' near line 411 [debug]: Parsing lib/jamf/version.rb [debug]: Parsing lib/jss/composer.rb [warn]: Unknown tag @options in file lib/jss/composer.rb near line 95 [debug]: Parsing lib/jss/validate.rb [debug]: Parsing lib/jamf/composer.rb [warn]: Unknown tag @options in file lib/jamf/composer.rb near line 95 [debug]: Parsing lib/jamf/validate.rb [debug]: Parsing lib/jss/api_object.rb [warn]: Unknown tag @init_data. in file lib/jss.rb near line 152 [warn]: @param tag has unknown parameter name: identfier in file lib/jss/api_object.rb' near line 584 [warn]: @param tag has unknown parameter name: identfier in filelib/jss/api_object.rb' near line 636 [warn]: @param tag has unknown parameter name: identfier in file lib/jss/api_object.rb' near line 668 [warn]: @param tag has unknown parameter name: name in filelib/jss/api_object.rb' near line 978 [warn]: @param tag has unknown parameter name: api in file lib/jss/api_object.rb' near line 978 [warn]: Unknown tag @seealso in filelib/jss/api_object.rbnear line 1224 [warn]: Unknown tag @subclasses.each [debug]: Parsing lib/jss/exceptions.rb [debug]: Parsing lib/jamf/exceptions.rb [debug]: Parsing lib/jss/compatibility.rb [debug]: Parsing lib/jss/configuration.rb [debug]: Parsing lib/jss/db_connection.rb [debug]: Parsing lib/jamf/compatibility.rb [debug]: Parsing lib/jamf/configuration.rb [debug]: Parsing lib/jss/api_connection.rb [warn]: @param tag has unknown parameter name: &block in filelib/jss/api_connection.rb' near line 1262 [warn]: @param tag has unknown parameter name: in file lib/jss/api_connection.rb' near line 1289 [debug]: Parsing lib/jss/api_object/mdm.rb [debug]: Parsing lib/jss/xml_workaround.rb [debug]: Parsing lib/jamf/api/connection.rb [warn]: @param tag has unknown parameter name: host: in filelib/jamf/api/connection.rb' near line 267 [warn]: @param tag has unknown parameter name: port: in file lib/jamf/api/connection.rb' near line 267 [warn]: @param tag has unknown parameter name: user: in filelib/jamf/api/connection.rb' near line 267 [warn]: @param tag has unknown parameter name: pw: in file lib/jamf/api/connection.rb' near line 267 [warn]: @param tag has unknown parameter name: token: in filelib/jamf/api/connection.rb' near line 267 [warn]: @param tag has unknown parameter name: open_timeout: in file lib/jamf/api/connection.rb' near line 267 [warn]: @param tag has unknown parameter name: timeout: in filelib/jamf/api/connection.rb' near line 267 [warn]: @param tag has unknown parameter name: ssl_version: in file lib/jamf/api/connection.rb' near line 267 [warn]: @param tag has unknown parameter name: verify_cert: in filelib/jamf/api/connection.rb' near line 267 [warn]: @param tag has unknown parameter name: params in file lib/jamf/api/connection.rb' near line 534 [warn]: @param tag has unknown parameter name: params in filelib/jamf/api/connection.rb' near line 703 [warn]: Unknown tag @keep_alive_thread in file lib/jamf/api/connection.rb near line 766 [warn]: @param tag has unknown parameter name: in file lib/jamf/api/connection.rb' near line 792 [debug]: Parsing lib/jss/api_object/site.rb [debug]: Parsing lib/jss/api_object/user.rb [debug]: Parsing lib/jss/ruby_extensions.rb [debug]: Parsing lib/jamf/ruby_extensions.rb [debug]: Parsing lib/jss/api_object/ebook.rb [debug]: Parsing lib/jss/api_object/group.rb [warn]: @param tag has unknown parameter name: m in filelib/jss/api_object/group.rb' near line 366 [warn]: @param tag has unknown parameter name: m in file lib/jss/api_object/group.rb' near line 378 [warn]: @param tag has unknown parameter name: api in filelib/jss/api_object/group.rb' near line 412 [debug]: Parsing lib/jss/api_object/policy.rb [warn]: @param tag has unknown parameter name: reboot_message in file lib/jss/api_object/policy.rb' near line 910 [warn]: @param tag has unknown parameter name: position in filelib/jss/api_object/policy.rb' near line 1159 [warn]: @param tag has unknown parameter name: action in file lib/jss/api_object/policy.rb' near line 1159 [warn]: @param tag has unknown parameter name: feu in filelib/jss/api_object/policy.rb' near line 1159 [warn]: @param tag has unknown parameter name: fut in file lib/jss/api_object/policy.rb' near line 1159 [warn]: @param tag has unknown parameter name: update_autorun in filelib/jss/api_object/policy.rb' near line 1159 [warn]: @param tag has unknown parameter name: identfier in file lib/jss/api_object/policy.rb' near line 1187 [warn]: @param tag has unknown parameter name: identfier in filelib/jss/api_object/policy.rb' near line 1277 [debug]: Parsing lib/jss/api_object/script.rb [debug]: Parsing lib/jss/api_object/account.rb [debug]: Parsing lib/jss/api_object/ibeacon.rb [debug]: Parsing lib/jss/api_object/package.rb [warn]: @param tag has unknown parameter name: @see in file lib/jss/api_object/package.rb' near line 661 [debug]: Parsing lib/jss/api_object/sitable.rb [debug]: Parsing lib/jss/api_object/vppable.rb [debug]: Parsing lib/jss/api_object/webhook.rb [debug]: Parsing lib/jss/client/jamf_binary.rb [debug]: Parsing lib/jss/client/jamf_helper.rb [debug]: Parsing lib/jamf/client/jamf_binary.rb [debug]: Parsing lib/jamf/client/jamf_helper.rb [debug]: Parsing lib/jss/api_object/building.rb [debug]: Parsing lib/jss/api_object/category.rb [debug]: Parsing lib/jss/api_object/computer.rb [warn]: Unknown tag @hardware in filelib/jss/api_object/computer.rbnear line 858 [debug]: Parsing lib/jss/api_object/scopable.rb [debug]: Parsing lib/jamf/api/mixins/abstract.rb [debug]: Parsing lib/jamf/api/mixins/lockable.rb [debug]: Parsing lib/jss/api_object/creatable.rb [warn]: @param tag has unknown parameter name: api in filelib/jss/api_object/creatable.rb' near line 74 [warn]: @param tag has unknown parameter name: name in file lib/jss/api_object/creatable.rb' near line 101 [debug]: Parsing lib/jss/api_object/locatable.rb [debug]: Parsing lib/jss/api_object/matchable.rb [debug]: Parsing lib/jss/api_object/updatable.rb [warn]: Unknown tag @see_also in filelib/jss/api_object/updatable.rbnear line 54 [debug]: Parsing lib/jss/ruby_extensions/hash.rb [debug]: Parsing lib/jss/ruby_extensions/time.rb [debug]: Parsing lib/jamf/api/connection/token.rb [debug]: Parsing lib/jamf/api/mixins/immutable.rb [debug]: Parsing lib/jamf/api/mixins/locatable.rb [debug]: Parsing lib/jamf/api/mixins/referable.rb [debug]: Parsing lib/jamf/ruby_extensions/hash.rb [debug]: Parsing lib/jss/api_object/department.rb [debug]: Parsing lib/jss/api_object/extendable.rb [debug]: Parsing lib/jss/api_object/peripheral.rb [debug]: Parsing lib/jss/api_object/uploadable.rb [debug]: Parsing lib/jss/ruby_extensions/array.rb [debug]: Parsing lib/jamf/api/mixins/change_log.rb [debug]: Parsing lib/jamf/api/mixins/extendable.rb [debug]: Parsing lib/jamf/api/mixins/searchable.rb [debug]: Parsing lib/jamf/ruby_extensions/array.rb [debug]: Parsing lib/jss/api_object/criteriable.rb [debug]: Parsing lib/jss/api_object/ldap_server.rb [warn]: @param tag has unknown parameter name: user in filelib/jss/api_object/ldap_server.rb' near line 140 [warn]: @param tag has unknown parameter name: server in file lib/jss/api_object/ldap_server.rb' near line 159 [debug]: Parsing lib/jss/api_object/patch_title.rb [debug]: Parsing lib/jss/api_object/purchasable.rb [debug]: Parsing lib/jss/ruby_extensions/ipaddr.rb [debug]: Parsing lib/jss/ruby_extensions/object.rb [debug]: Parsing lib/jss/ruby_extensions/string.rb [debug]: Parsing lib/jamf/api/mixins/uncreatable.rb [debug]: Parsing lib/jamf/api/mixins/undeletable.rb [debug]: Parsing lib/jamf/ruby_extensions/ipaddr.rb [debug]: Parsing lib/jamf/ruby_extensions/object.rb [debug]: Parsing lib/jamf/ruby_extensions/string.rb [debug]: Parsing lib/jss/api_object/patch_policy.rb [warn]: @param tag has unknown parameter name: new_tgt_vers in filelib/jss/api_object/patch_policy.rb' near line 287 [warn]: @param tag has unknown parameter name: new_val in file lib/jss/api_object/patch_policy.rb' near line 313 [warn]: @param tag has unknown parameter name: new_val in filelib/jss/api_object/patch_policy.rb' near line 320 [warn]: @param tag has unknown parameter name: days in file lib/jss/api_object/patch_policy.rb' near line 328 [warn]: @param tag has unknown parameter name: new_period in filelib/jss/api_object/patch_policy.rb' near line 334 [warn]: @param tag has unknown parameter name: subj in file lib/jss/api_object/patch_policy.rb' near line 341 [warn]: @param tag has unknown parameter name: subj in filelib/jss/api_object/patch_policy.rb' near line 348 [warn]: @param tag has unknown parameter name: new_title in file lib/jss/api_object/patch_policy.rb' near line 558 [debug]: Parsing lib/jss/api_object/patch_source.rb [warn]: @param tag has unknown parameter name: newname in filelib/jss/api_object/patch_source.rb' near line 288 [warn]: @param tag has unknown parameter name: new_port in file lib/jss/api_object/patch_source.rb' near line 295 [debug]: Parsing lib/jss/api_object/categorizable.rb [debug]: Parsing lib/jss/api_object/mobile_device.rb [debug]: Parsing lib/jss/api_object/self_servable.rb [warn]: @param tag has unknown parameter name: new_val in filelib/jss/api_object/self_servable.rb' near line 574 [debug]: Parsing lib/jss/client/management_action.rb [debug]: Parsing lib/jss/ruby_extensions/filetest.rb [debug]: Parsing lib/jss/ruby_extensions/pathname.rb [debug]: Parsing lib/jamf/api/connection/api_error.rb [warn]: @param tag has unknown parameter name: rest_error in file lib/jamf/api/connection/api_error.rb' near line 83 [debug]: Parsing lib/jamf/api/json_objects/country.rb [debug]: Parsing lib/jamf/client/management_action.rb [debug]: Parsing lib/jamf/ruby_extensions/filetest.rb [debug]: Parsing lib/jamf/ruby_extensions/pathname.rb [debug]: Parsing lib/jss/api_object/netboot_server.rb [debug]: Parsing lib/jss/api_object/scopable/scope.rb [debug]: Parsing lib/jamf/api/json_objects/location.rb [warn]: @param tag has unknown parameter name: in filelib/jamf/api/json_objects/location.rb' near line 34 [warn]: @param tag has unknown parameter name: in file lib/jamf/api/json_objects/location.rb' near line 41 [warn]: @param tag has unknown parameter name: in filelib/jamf/api/json_objects/location.rb' near line 48 [warn]: @param tag has unknown parameter name: in file lib/jamf/api/json_objects/location.rb' near line 55 [warn]: @param tag has unknown parameter name: in filelib/jamf/api/json_objects/location.rb' near line 62 [warn]: @param tag has unknown parameter name: in file lib/jamf/api/json_objects/location.rb' near line 69 [warn]: @param tag has unknown parameter name: in filelib/jamf/api/json_objects/location.rb' near line 76 [warn]: @param tag has unknown parameter name: in file lib/jamf/api/json_objects/location.rb' near line 83 [debug]: Parsing lib/jamf/api/mixins/bulk_deletable.rb [debug]: Parsing lib/jss/api_object/advanced_search.rb [debug]: Parsing lib/jss/api_object/mac_application.rb [debug]: Parsing lib/jss/api_object/network_segment.rb [warn]: @param tag has unknown parameter name: starting in filelib/jss/api_object/network_segment.rb' near line 165 [warn]: Unknown tag @see_also in file lib/jss/api_object/network_segment.rb near line 291 [warn]: @param tag has unknown parameter name: other_segment in file lib/jss/api_object/network_segment.rb' near line 363 [warn]: Unknown tag @see_also in filelib/jss/api_object/network_segment.rbnear line 514 [debug]: Parsing lib/jss/api_object/peripheral_type.rb [debug]: Parsing lib/jamf/api/json_objects/criterion.rb [debug]: Parsing lib/jss/api_object/group/user_group.rb [debug]: Parsing lib/jamf/api/json_objects/attachment.rb [debug]: Parsing lib/jamf/ruby_extensions/array/utils.rb [debug]: Parsing lib/jss/api_object/removable_macaddr.rb [debug]: Parsing lib/jamf/api/json_objects/ios_details.rb [debug]: Parsing lib/jamf/ruby_extensions/ipaddr/utils.rb [debug]: Parsing lib/jss/api_object/distribution_point.rb [debug]: Parsing lib/jss/api_object/management_history.rb [debug]: Parsing lib/jss/api_object/self_servable/icon.rb [debug]: Parsing lib/jamf/api/abstract_classes/prestage.rb [warn]: Unknown tag @paream in filelib/jamf/api/abstract_classes/prestage.rbnear line 236 [warn]: Unknown tag @paream in filelib/jamf/api/abstract_classes/prestage.rbnear line 281 [debug]: Parsing lib/jamf/api/abstract_classes/resource.rb [warn]: Unknown tag @see_also in filelib/jamf/api/abstract_classes/resource.rbnear line 181 [debug]: Parsing lib/jss/api_object/computer_invitation.rb [debug]: Parsing lib/jss/api_object/extension_attribute.rb [warn]: @param tag has unknown parameter name: new_val in filelib/jss/api_object/extension_attribute.rb' near line 361 [debug]: Parsing lib/jss/api_object/patch_title/version.rb [debug]: Parsing lib/jss/api_object/restricted_software.rb [debug]: Parsing lib/jamf/api/json_objects/account_prefs.rb [debug]: Parsing lib/jamf/ruby_extensions/hash/backports.rb [debug]: Parsing lib/jamf/ruby_extensions/pathname/utils.rb [debug]: Parsing lib/jss/api_object/criteriable/criteria.rb [debug]: Parsing lib/jss/api_object/group/computer_group.rb [debug]: Parsing lib/jamf/api/attribute_classes/timestamp.rb [debug]: Parsing lib/jamf/api/json_objects/prestage_scope.rb [debug]: Parsing lib/jss/api_object/configuration_profile.rb [debug]: Parsing lib/jss/api_object/criteriable/criterion.rb [warn]: @param tag has unknown parameter name: side in file lib/jss/api_object/criteriable/criterion.rb' near line 169 [debug]: Parsing lib/jss/ruby_extensions/string/backports.rb [debug]: Parsing lib/jamf/api/abstract_classes/json_object.rb [debug]: Parsing lib/jamf/api/attribute_classes/ip_address.rb [debug]: Parsing lib/jamf/api/json_objects/android_details.rb [debug]: Parsing lib/jamf/api/json_objects/appletv_details.rb [debug]: Parsing lib/jamf/api/json_objects/installed_ebook.rb [debug]: Parsing lib/jamf/api/json_objects/purchasing_data.rb [warn]: @param tag has unknown parameter name: in filelib/jamf/api/json_objects/purchasing_data.rb' near line 36 [warn]: @param tag has unknown parameter name: in file lib/jamf/api/json_objects/purchasing_data.rb' near line 43 [warn]: @param tag has unknown parameter name: in filelib/jamf/api/json_objects/purchasing_data.rb' near line 50 [warn]: @param tag has unknown parameter name: in file lib/jamf/api/json_objects/purchasing_data.rb' near line 57 [warn]: @param tag has unknown parameter name: in filelib/jamf/api/json_objects/purchasing_data.rb' near line 64 [warn]: @param tag has unknown parameter name: in file lib/jamf/api/json_objects/purchasing_data.rb' near line 71 [warn]: @param tag has unknown parameter name: in filelib/jamf/api/json_objects/purchasing_data.rb' near line 78 [warn]: @param tag has unknown parameter name: in file lib/jamf/api/json_objects/purchasing_data.rb' near line 85 [warn]: @param tag has unknown parameter name: in filelib/jamf/api/json_objects/purchasing_data.rb' near line 92 [warn]: @param tag has unknown parameter name: in file lib/jamf/api/json_objects/purchasing_data.rb' near line 99 [warn]: @param tag has unknown parameter name: in filelib/jamf/api/json_objects/purchasing_data.rb' near line 106 [warn]: @param tag has unknown parameter name: in file lib/jamf/api/json_objects/purchasing_data.rb' near line 113 [debug]: Parsing lib/jamf/ruby_extensions/array/predicates.rb [debug]: Parsing lib/jamf/ruby_extensions/string/backports.rb [debug]: Parsing lib/jss/api_object/software_update_server.rb [debug]: Parsing lib/jss/ruby_extensions/string/predicates.rb [debug]: Parsing lib/jamf/api/json_objects/cellular_network.rb [debug]: Parsing lib/jamf/api/json_objects/change_log_entry.rb [debug]: Parsing lib/jamf/api/json_objects/md_prestage_name.rb [debug]: Parsing lib/jamf/ruby_extensions/object/predicates.rb [debug]: Parsing lib/jamf/ruby_extensions/string/predicates.rb [debug]: Parsing lib/jss/ruby_extensions/string/conversions.rb [debug]: Parsing lib/jamf/api/json_objects/md_prestage_names.rb [debug]: Parsing lib/jamf/api/json_objects/prestage_location.rb [warn]: @param tag has unknown parameter name: in filelib/jamf/api/json_objects/prestage_location.rb' near line 43 [warn]: @param tag has unknown parameter name: in file lib/jamf/api/json_objects/prestage_location.rb' near line 50 [warn]: @param tag has unknown parameter name: in filelib/jamf/api/json_objects/prestage_location.rb' near line 57 [warn]: @param tag has unknown parameter name: in file lib/jamf/api/json_objects/prestage_location.rb' near line 64 [warn]: @param tag has unknown parameter name: in filelib/jamf/api/json_objects/prestage_location.rb' near line 71 [warn]: @param tag has unknown parameter name: in file lib/jamf/api/json_objects/prestage_location.rb' near line 78 [warn]: @param tag has unknown parameter name: in filelib/jamf/api/json_objects/prestage_location.rb' near line 85 [warn]: @param tag has unknown parameter name: in file `lib/jamf/api/json_objects/prestage_location.rb' near line 92 [debug]: Parsing lib/jamf/ruby_extensions/string/conversions.rb [debug]: Parsing lib/jss/api_object/management_history/ebook.rb [warn]: in YARD::Handlers::Ruby::ClassHandler: Undocumentable superclass (class was added without superclass) in file 'lib/jss/api_object/management_history/ebook.rb':42: 

    42: class EBook < ImmutableStruct.new(

[debug]: Parsing lib/jamf/api/connection/api_error_styleguide.rb [debug]: Parsing lib/jamf/ruby_extensions/filetest/predicates.rb [debug]: Parsing lib/jamf/ruby_extensions/pathname/predicates.rb [debug]: Parsing lib/jss/api_object/group/mobile_device_group.rb [debug]: Parsing lib/jss/api_object/mobile_device_application.rb [debug]: Parsing lib/jamf/api/abstract_classes/advanced_search.rb [debug]: Parsing lib/jamf/api/json_objects/prestage_assignment.rb [debug]: Parsing lib/jamf/api/json_objects/prestage_sync_status.rb [debug]: Parsing lib/jss/api_object/management_history/hashlike.rb [debug]: Parsing lib/jamf/api/abstract_classes/generic_reference.rb [debug]: Parsing lib/jamf/api/json_objects/installed_application.rb [debug]: Parsing lib/jamf/api/json_objects/installed_certificate.rb [debug]: Parsing lib/jamf/api/json_objects/mobile_device_details.rb [warn]: @param tag has unknown parameter name: in file lib/jamf/api/json_objects/mobile_device_details.rb' near line 90 [warn]: @param tag has unknown parameter name: in filelib/jamf/api/json_objects/mobile_device_details.rb' near line 99 [warn]: @param tag has unknown parameter name: in file lib/jamf/api/json_objects/mobile_device_details.rb' near line 115 [warn]: @param tag has unknown parameter name: @see in filelib/jamf/api/json_objects/mobile_device_details.rb' near line 162 [debug]: Parsing lib/jamf/api/abstract_classes/singleton_resource.rb [warn]: @param tag has unknown parameter name: version in file `lib/jamf/api/abstract_classes/singleton_resource.rb' near line 58 [debug]: Parsing lib/jamf/api/json_objects/mobile_device_security.rb [debug]: Parsing lib/jamf/api/resources/collection_resources/site.rb [debug]: Parsing lib/jss/api_object/computer/application_installs.rb [debug]: Parsing lib/jss/api_object/management_history/policy_log.rb [warn]: in YARD::Handlers::Ruby::ClassHandler: Undocumentable superclass (class was added without superclass) in file 'lib/jss/api_object/management_history/policy_log.rb':38: 

    38: class PolicyLog < ImmutableStruct.new(

[debug]: Parsing lib/jamf/api/abstract_classes/collection_resource.rb [warn]: @param tag has unknown parameter name: ident: in file `lib/jamf/api/abstract_classes/collection_resource.rb' near line 210 [debug]: Parsing lib/jss/api_object/management_history/audit_event.rb [warn]: in YARD::Handlers::Ruby::ClassHandler: Undocumentable superclass (class was added without superclass) in file 'lib/jss/api_object/management_history/audit_event.rb':38: 

    38: class AuditEvent < ImmutableStruct.new(

[debug]: Parsing lib/jss/api_object/management_history/mdm_command.rb [warn]: in YARD::Handlers::Ruby::ClassHandler: Undocumentable superclass (class was added without superclass) in file 'lib/jss/api_object/management_history/mdm_command.rb':41: 

    41: class MDMCommand < ImmutableStruct.new(

[debug]: Parsing lib/jamf/api/json_objects/device_enrollment_device.rb [debug]: Parsing lib/jamf/api/json_objects/prestage_purchasing_data.rb [warn]: @param tag has unknown parameter name: in file lib/jamf/api/json_objects/prestage_purchasing_data.rb' near line 43 [warn]: @param tag has unknown parameter name: in filelib/jamf/api/json_objects/prestage_purchasing_data.rb' near line 50 [warn]: @param tag has unknown parameter name: in file lib/jamf/api/json_objects/prestage_purchasing_data.rb' near line 57 [warn]: @param tag has unknown parameter name: in filelib/jamf/api/json_objects/prestage_purchasing_data.rb' near line 64 [warn]: @param tag has unknown parameter name: in file lib/jamf/api/json_objects/prestage_purchasing_data.rb' near line 71 [warn]: @param tag has unknown parameter name: in filelib/jamf/api/json_objects/prestage_purchasing_data.rb' near line 78 [warn]: @param tag has unknown parameter name: in file lib/jamf/api/json_objects/prestage_purchasing_data.rb' near line 85 [warn]: @param tag has unknown parameter name: in filelib/jamf/api/json_objects/prestage_purchasing_data.rb' near line 92 [warn]: @param tag has unknown parameter name: in file lib/jamf/api/json_objects/prestage_purchasing_data.rb' near line 99 [warn]: @param tag has unknown parameter name: in filelib/jamf/api/json_objects/prestage_purchasing_data.rb' near line 106 [warn]: @param tag has unknown parameter name: in file lib/jamf/api/json_objects/prestage_purchasing_data.rb' near line 113 [warn]: @param tag has unknown parameter name: in filelib/jamf/api/json_objects/prestage_purchasing_data.rb' near line 120 [debug]: Parsing lib/jamf/api/resources/collection_resources/script.rb [debug]: Parsing lib/jamf/api/json_objects/extension_attribute_value.rb [debug]: Parsing lib/jamf/api/resources/collection_resources/account.rb [debug]: Parsing lib/jamf/api/resources/collection_resources/building.rb [debug]: Parsing lib/jamf/api/resources/collection_resources/category.rb [debug]: Parsing lib/jamf/api/resources/collection_resources/computer.rb [debug]: Parsing lib/jamf/api/resources/collection_resources/time_zone.rb [debug]: Parsing lib/jss/api_object/patch_source/patch_external_source.rb [debug]: Parsing lib/jss/api_object/patch_source/patch_internal_source.rb [debug]: Parsing lib/jamf/api/json_objects/md_prestage_skip_setup_items.rb [debug]: Parsing lib/jamf/api/resources/collection_resources/department.rb [debug]: Parsing lib/jamf/api/abstract_classes/prestage_skip_setup_items.rb [debug]: Parsing lib/jamf/api/json_objects/device_enrollment_sync_status.rb [debug]: Parsing lib/jss/api_object/advanced_search/advanced_user_search.rb [debug]: Parsing lib/jss/api_object/management_history/casper_remote_log.rb [warn]: in YARD::Handlers::Ruby::ClassHandler: Undocumentable superclass (class was added without superclass) in file 'lib/jss/api_object/management_history/casper_remote_log.rb':38: 

    38: class CasperRemoteLog < ImmutableStruct.new(

[debug]: Parsing lib/jss/api_object/management_history/mac_app_store_app.rb [warn]: in YARD::Handlers::Ruby::ClassHandler: Undocumentable superclass (class was added without superclass) in file 'lib/jss/api_object/management_history/mac_app_store_app.rb':41: 

    41: class MacAppStoreApp < ImmutableStruct.new(

[debug]: Parsing lib/jss/api_object/management_history/mobile_device_app.rb [warn]: @param tag has unknown parameter name: A in file `lib/jss/api_object/management_history/mobile_device_app.rb' near line 110 [warn]: in YARD::Handlers::Ruby::ClassHandler: Undocumentable superclass (class was added without superclass) in file 'lib/jss/api_object/management_history/mobile_device_app.rb':41: 

    41: class MobileDeviceApp < ImmutableStruct.new(

[debug]: Parsing lib/jamf/api/json_objects/installed_provisioning_profile.rb [debug]: Parsing lib/jamf/api/resources/singleton_resources/authorization.rb [debug]: Parsing lib/jss/api_object/management_history/casper_imaging_log.rb [warn]: in YARD::Handlers::Ruby::ClassHandler: Undocumentable superclass (class was added without superclass) in file 'lib/jss/api_object/management_history/casper_imaging_log.rb':38: 

    38: class CasperImagingLog < ImmutableStruct.new(

[debug]: Parsing lib/jss/api_object/management_history/computer_usage_log.rb [warn]: in YARD::Handlers::Ruby::ClassHandler: Undocumentable superclass (class was added without superclass) in file 'lib/jss/api_object/management_history/computer_usage_log.rb':38: 

    38: class ComputerUsageLog < ImmutableStruct.new(

[debug]: Parsing lib/jss/api_object/management_history/screen_sharing_log.rb [warn]: in YARD::Handlers::Ruby::ClassHandler: Undocumentable superclass (class was added without superclass) in file 'lib/jss/api_object/management_history/screen_sharing_log.rb':38: 

    38: class ScreenSharingLog < ImmutableStruct.new(

[debug]: Parsing lib/jamf/api/json_objects/installed_configuration_profile.rb [debug]: Parsing lib/jamf/api/resources/collection_resources/mobile_device.rb [warn]: @param tag has unknown parameter name: in file lib/jamf/api/resources/collection_resources/mobile_device.rb' near line 86 [warn]: @param tag has unknown parameter name: in filelib/jamf/api/resources/collection_resources/mobile_device.rb' near line 139 [debug]: Parsing lib/jss/api_object/management_history/user_location_change.rb [warn]: in YARD::Handlers::Ruby::ClassHandler: Undocumentable superclass (class was added without superclass) in file 'lib/jss/api_object/management_history/user_location_change.rb':38: 

    38: class UserLocationChange < ImmutableStruct.new(

[debug]: Parsing lib/jss/api_object/advanced_search/advanced_computer_search.rb [debug]: Parsing lib/jamf/api/json_objects/computer_prestage_skip_setup_items.rb [debug]: Parsing lib/jamf/api/resources/collection_resources/computer_prestage.rb [debug]: Parsing lib/jamf/api/resources/collection_resources/device_enrollment.rb [warn]: Unknown tag @pararm in file lib/jamf/api/resources/collection_resources/device_enrollment.rb near line 251 [debug]: Parsing lib/jamf/api/json_objects/inventory_preload_extension_attribute.rb [debug]: Parsing lib/jamf/api/resources/collection_resources/extension_attribute.rb [debug]: Parsing lib/jss/api_object/extension_attribute/user_extension_attribute.rb [debug]: Parsing lib/jamf/api/resources/collection_resources/advanced_user_search.rb [debug]: Parsing lib/jamf/api/resources/singleton_resources/reenrollment_settings.rb [warn]: @param tag has unknown parameter name: a in file lib/jamf/api/resources/singleton_resources/reenrollment_settings.rb' near line 82 [debug]: Parsing lib/jss/api_object/advanced_search/advanced_mobile_device_search.rb [debug]: Parsing lib/jamf/api/resources/collection_resources/mobile_device_prestage.rb [debug]: Parsing lib/jamf/api/resources/singleton_resources/app_store_country_codes.rb [warn]: @param tag has unknown parameter name: name in filelib/jamf/api/resources/singleton_resources/app_store_country_codes.rb' near line 125 [debug]: Parsing lib/jamf/api/resources/singleton_resources/client_checkin_settings.rb [debug]: Parsing lib/jss/api_object/configuration_profile/osx_configuration_profile.rb [debug]: Parsing lib/jss/api_object/extension_attribute/computer_extension_attribute.rb [debug]: Parsing lib/jamf/api/resources/collection_resources/inventory_preload_record.rb [debug]: Parsing lib/jss/api_object/extension_attribute/mobile_device_extension_attribute.rb [debug]: Parsing lib/jamf/api/resources/collection_resources/advanced_mobile_device_search.rb [debug]: Parsing lib/jss/api_object/configuration_profile/mobile_device_configuration_profile.rb [debug]: Serializing to .yardoc/objects/root.dat [debug]: Re-generating object ... [debug]: Re-generating object JSS... [debug]: Re-generating object JSS::Composer... [debug]: Re-generating object JSS::Creatable... [debug]: Re-generating object JSS::FileUpload... [debug]: Re-generating object JSS::Locatable... [debug]: Re-generating object JSS::Matchable... [debug]: Re-generating object JSS::Purchasable... [debug]: Re-generating object JSS::Updatable... [debug]: Re-generating object JSS::Extendable... [debug]: Re-generating object JSS::SelfServable... [debug]: Re-generating object JSS::Categorizable... [debug]: Re-generating object JSS::VPPable... [debug]: Re-generating object JSS::Sitable... [debug]: Re-generating object JSS::MDM... [debug]: Re-generating object JSS::ManagementHistory... [debug]: Re-generating object JSS::Criteriable... [debug]: Re-generating object JSS::Scopable... [debug]: Re-generating object Jamf... [debug]: Re-generating object JSS::Validate... [debug]: Re-generating object Jamf::Composer... [debug]: Re-generating object Jamf::Validate... [debug]: Re-generating object JSS::MDM::ClassMethods... [debug]: Re-generating object JSS::XMLWorkaround... [debug]: Re-generating object Jamf::Abstract... [debug]: Re-generating object Jamf::Lockable... [debug]: Re-generating object Jamf::Immutable... [debug]: Re-generating object Jamf::Locatable... [debug]: Re-generating object Jamf::Referable... [debug]: Re-generating object JSS::Uploadable... [debug]: Re-generating object Jamf::ChangeLog... [debug]: Re-generating object Jamf::Extendable... [debug]: Re-generating object Jamf::Searchable... [debug]: Re-generating object Jamf::UnCreatable... [debug]: Re-generating object Jamf::UnDeletable... [debug]: Re-generating object FileTest... [debug]: Re-generating object JamfRubyExtensions... [debug]: Re-generating object JamfRubyExtensions::Array... [debug]: Re-generating object JamfRubyExtensions::Array::Utils... [debug]: Re-generating object JamfRubyExtensions::IPAddr... [debug]: Re-generating object JamfRubyExtensions::IPAddr::Utils... [debug]: Re-generating object JSS::ManagementHistory::ClassMethods... [debug]: Re-generating object JamfRubyExtensions::Hash... [debug]: Re-generating object JamfRubyExtensions::Hash::BackPorts... [debug]: Re-generating object JamfRubyExtensions::Pathname... [debug]: Re-generating object JamfRubyExtensions::Pathname::Utils... [debug]: Re-generating object JSSRubyExtensions... [debug]: Re-generating object JSSRubyExtensions::String... [debug]: Re-generating object JSSRubyExtensions::String::BackPorts... [debug]: Re-generating object JamfRubyExtensions::Array::Predicates... [debug]: Re-generating object JamfRubyExtensions::String... [debug]: Re-generating object JamfRubyExtensions::String::BackPorts... [debug]: Re-generating object JSSRubyExtensions::String::Predicates... [debug]: Re-generating object JamfRubyExtensions::Object... [debug]: Re-generating object JamfRubyExtensions::Object::Predicates... [debug]: Re-generating object JamfRubyExtensions::String::Predicates... [debug]: Re-generating object JSSRubyExtensions::String::Conversions... [debug]: Re-generating object JamfRubyExtensions::String::Conversions... [debug]: Re-generating object JamfRubyExtensions::FileTest... [debug]: Re-generating object JamfRubyExtensions::FileTest::Predicates... [debug]: Re-generating object JamfRubyExtensions::Pathname::Predicates... [debug]: Re-generating object JSS::ManagementHistory::HashLike... [debug]: Re-generating object JSS::Criteriable::Criteria... [debug]: Re-generating object JSS::Criteriable::Criterion... [debug]: Re-generating object JSS::Scopable::Scope... [debug]: Re-generating object JSS::APIConnection... [debug]: Re-generating object JSS::DBConnection... [debug]: Re-generating object JSS::Server... [debug]: Re-generating object JSS::Icon... [debug]: Re-generating object JSS::Preferences... [debug]: Re-generating object JSS::Client... [debug]: Re-generating object JSS::APIObject... [debug]: Re-generating object JSS::AdvancedSearch... [debug]: Re-generating object JSS::AdvancedComputerSearch... [debug]: Re-generating object JSS::AdvancedMobileDeviceSearch... [debug]: Re-generating object JSS::AdvancedUserSearch... [debug]: Re-generating object JSS::ExtensionAttribute... [debug]: Re-generating object JSS::ComputerExtensionAttribute... [debug]: Re-generating object JSS::MobileDeviceExtensionAttribute... [debug]: Re-generating object JSS::UserExtensionAttribute... [debug]: Re-generating object JSS::Group... [debug]: Re-generating object JSS::ComputerGroup... [debug]: Re-generating object JSS::MobileDeviceGroup... [debug]: Re-generating object JSS::UserGroup... [debug]: Re-generating object JSS::ConfigurationProfile... [debug]: Re-generating object JSS::OSXConfigurationProfile... [debug]: Re-generating object JSS::MobileDeviceConfigurationProfile... [debug]: Re-generating object JSS::Account... [debug]: Re-generating object JSS::Building... [debug]: Re-generating object JSS::Category... [debug]: Re-generating object JSS::Computer... [debug]: Re-generating object JSS::Department... [debug]: Re-generating object JSS::EBook... [debug]: Re-generating object JSS::DistributionPoint... [debug]: Re-generating object JSS::LDAPServer... [debug]: Re-generating object JSS::MacApplication... [debug]: Re-generating object JSS::MobileDevice... [debug]: Re-generating object JSS::MobileDeviceApplication... [debug]: Re-generating object JSS::NetBootServer... [debug]: Re-generating object JSS::NetworkSegment... [debug]: Re-generating object JSS::Package... [debug]: Re-generating object JSS::PatchPolicy... [debug]: Re-generating object JSS::PeripheralType... [debug]: Re-generating object JSS::Peripheral... [debug]: Re-generating object JSS::Policy... [debug]: Re-generating object JSS::RemovableMacAddress... [debug]: Re-generating object JSS::RestrictedSoftware... [debug]: Re-generating object JSS::Script... [debug]: Re-generating object JSS::Site... [debug]: Re-generating object JSS::SoftwareUpdateServer... [debug]: Re-generating object JSS::User... [debug]: Re-generating object JSS::WebHook... [debug]: Re-generating object JSS::MissingDataError... [debug]: Re-generating object JSS::InvalidDataError... [debug]: Re-generating object JSS::InvalidConnectionError... [debug]: Re-generating object JSS::NoSuchItemError... [debug]: Re-generating object JSS::AlreadyExistsError... [debug]: Re-generating object JSS::AmbiguousError... [debug]: Re-generating object JSS::FileServiceError... [debug]: Re-generating object JSS::UnmanagedError... [debug]: Re-generating object JSS::UnsupportedError... [debug]: Re-generating object JSS::TimeoutError... [debug]: Re-generating object JSS::AuthenticationError... [debug]: Re-generating object JSS::ConflictError... [debug]: Re-generating object JSS::BadRequestError... [debug]: Re-generating object JSS::APIRequestError... [debug]: Re-generating object Jamf::MissingDataError... [debug]: Re-generating object Jamf::InvalidDataError... [debug]: Re-generating object Jamf::InvalidConnectionError... [debug]: Re-generating object Jamf::NoSuchItemError... [debug]: Re-generating object Jamf::AlreadyExistsError... [debug]: Re-generating object Jamf::FileServiceError... [debug]: Re-generating object Jamf::UnmanagedError... [debug]: Re-generating object Jamf::UnsupportedError... [debug]: Re-generating object Jamf::TimeoutError... [debug]: Re-generating object Jamf::AuthenticationError... [debug]: Re-generating object Jamf::ConflictError... [debug]: Re-generating object Jamf::VersionLockError... [debug]: Re-generating object Jamf::BadRequestError... [debug]: Re-generating object Jamf::APIRequestError... [debug]: Re-generating object Hash... [debug]: Re-generating object Array... [debug]: Re-generating object String... [debug]: Re-generating object JSS::Configuration... [debug]: Re-generating object Jamf::Configuration... [debug]: Re-generating object Jamf::Connection... [debug]: Re-generating object JSS::IBeacon... [debug]: Re-generating object Time... [debug]: Re-generating object Jamf::Connection::Token... [debug]: Re-generating object Jamf::Locatable::User... [debug]: Re-generating object Jamf::Searchable::OrderBy... [debug]: Re-generating object Jamf::Searchable::SeachParams... [debug]: Re-generating object JSS::PatchTitle... [debug]: Re-generating object IPAddr... [debug]: Re-generating object Object... [debug]: Re-generating object JSS::PatchSource... [debug]: Re-generating object Pathname... [debug]: Re-generating object Jamf::Connection::APIError... [debug]: Re-generating object Jamf::Country... [debug]: Re-generating object Jamf::Location... [debug]: Re-generating object Jamf::Criterion... [debug]: Re-generating object Jamf::Attachment... [debug]: Re-generating object Jamf::IosDetails... [debug]: Re-generating object Jamf::Prestage... [debug]: Re-generating object Jamf::Resource... [debug]: Re-generating object JSS::ComputerInvitation... [debug]: Re-generating object JSS::PatchTitle::Version... [debug]: Re-generating object Jamf::AccountPreferences... [debug]: Re-generating object Jamf::Timestamp... [debug]: Re-generating object Jamf::PrestageScope... [debug]: Re-generating object Jamf::JSONObject... [debug]: Re-generating object Jamf::IPAddress... [debug]: Re-generating object Jamf::AndroidDetails... [debug]: Re-generating object Jamf::AppleTVDetails... [debug]: Re-generating object Jamf::InstalledEBook... [debug]: Re-generating object Jamf::PurchasingData... [debug]: Re-generating object Jamf::CellularNetwork... [debug]: Re-generating object Jamf::ChangeLogEntry... [debug]: Re-generating object Jamf::MobileDevicePrestageName... [debug]: Re-generating object Jamf::MobileDevicePrestageNames... [debug]: Re-generating object Jamf::PrestageLocation... [debug]: Re-generating object JSS::ManagementHistory::EBook... [debug]: Re-generating object Jamf::APIError... [debug]: Re-generating object Jamf::APIErrorDetail... [debug]: Re-generating object Jamf::AdvancedSearch... [debug]: Re-generating object Jamf::PrestageAssignment... [debug]: Re-generating object Jamf::PrestageSyncStatus... [debug]: Re-generating object Jamf::GenericReference... [debug]: Re-generating object Jamf::InstalledApplication... [debug]: Re-generating object Jamf::InstalledCertificate... [debug]: Re-generating object Jamf::MobileDeviceDetails... [debug]: Re-generating object Jamf::SingletonResource... [debug]: Re-generating object Jamf::MobileDeviceSecurity... [debug]: Re-generating object Jamf::Site... [debug]: Re-generating object JSS::ManagementHistory::PolicyLog... [debug]: Re-generating object Jamf::CollectionResource... [debug]: Re-generating object JSS::ManagementHistory::AuditEvent... [debug]: Re-generating object JSS::ManagementHistory::MDMCommand... [debug]: Re-generating object Jamf::DeviceEnrollmentDevice... [debug]: Re-generating object Jamf::PrestagePurchasingData... [debug]: Re-generating object Jamf::Script... [debug]: Re-generating object Jamf::ExtensionAttributeValue... [debug]: Re-generating object Jamf::Account... [debug]: Re-generating object Jamf::Building... [debug]: Re-generating object Jamf::Category... [debug]: Re-generating object Jamf::Computer... [debug]: Re-generating object Jamf::TimeZone... [debug]: Re-generating object JSS::PatchExternalSource... [debug]: Re-generating object JSS::PatchInternalSource... [debug]: Re-generating object Jamf::MobileDevicePrestageSkipSetupItems... [debug]: Re-generating object Jamf::Department... [debug]: Re-generating object Jamf::PrestageSkipSetupItems... [debug]: Re-generating object Jamf::DeviceEnrollmentSyncStatus... [debug]: Re-generating object JSS::ManagementHistory::CasperRemoteLog... [debug]: Re-generating object JSS::ManagementHistory::MacAppStoreApp... [debug]: Re-generating object JSS::ManagementHistory::MobileDeviceApp... [debug]: Re-generating object Jamf::InstalledProvisioningProfile... [debug]: Re-generating object Jamf::Authorization... [debug]: Re-generating object JSS::ManagementHistory::CasperImagingLog... [debug]: Re-generating object JSS::ManagementHistory::ComputerUsageLog... [debug]: Re-generating object JSS::ManagementHistory::ScreenSharingLog... [debug]: Re-generating object Jamf::InstalledConfigurationProfile... [debug]: Re-generating object Jamf::MobileDevice... [debug]: Re-generating object JSS::ManagementHistory::UserLocationChange... [debug]: Re-generating object Jamf::ComputerPrestageSkipSetupItems... [debug]: Re-generating object Jamf::ComputerPrestage... [debug]: Re-generating object Jamf::DeviceEnrollment... [debug]: Re-generating object Jamf::InventoryPreloadExtensionAttribute... [debug]: Re-generating object Jamf::ExtensionAttribute... [debug]: Re-generating object Jamf::AdvancedUserSearch... [debug]: Re-generating object Jamf::ReEnrollmentSettings... [debug]: Re-generating object Jamf::MobileDevicePrestage... [debug]: Re-generating object Jamf::AppStoreCountryCodes... [debug]: Re-generating object Jamf::ClientCheckInSettings... [debug]: Re-generating object Jamf::InventoryPreloadRecord... [debug]: Re-generating object Jamf::AdvancedMobileDeviceSearch... [debug]: Generating asset js/jquery.js [debug]: Serializing to /tmp/fixyard/js/jquery.js [debug]: Generating asset js/app.js [debug]: Serializing to /tmp/fixyard/js/app.js [debug]: Generating asset js/full_list.js [debug]: Serializing to /tmp/fixyard/js/full_list.js [debug]: Generating asset css/style.css [debug]: Serializing to /tmp/fixyard/css/style.css [debug]: Generating asset css/common.css [debug]: Serializing to /tmp/fixyard/css/common.css [debug]: Generating asset css/full_list.css [debug]: Serializing to /tmp/fixyard/css/full_list.css [debug]: Generating asset class_list.html [debug]: Serializing to /tmp/fixyard/class_list.html [debug]: Generating asset method_list.html [debug]: Serializing to /tmp/fixyard/method_list.html [debug]: Generating asset file_list.html [debug]: Serializing to /tmp/fixyard/file_list.html [debug]: Generating asset frames.html [debug]: Serializing to /tmp/fixyard/frames.html [debug]: Serializing to /tmp/fixyard/_index.html Traceback (most recent call last): 51: from /usr/local/bin/yard:23:in <main>' 50: from /usr/local/bin/yard:23:inload' 49: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/bin/yard:13:in <top (required)>' 48: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/cli/command_parser.rb:54:inrun' 47: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/cli/command_parser.rb:72:in run' 46: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/cli/command.rb:14:inrun' 45: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/cli/yardoc.rb:267:in run' 44: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/cli/yardoc.rb:356:inrun_generate' 43: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/templates/engine.rb:105:in generate' 42: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/templates/template.rb:136:inrun' 41: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/templates/template.rb:131:in new' 40: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/templates/template.rb:193:ininitialize' 39: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/templates/default/fulldoc/html/setup.rb:10:in init' 38: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/templates/default/fulldoc/html/setup.rb:10:ineach_with_index' 37: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/templates/default/fulldoc/html/setup.rb:10:in each' 36: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/templates/default/fulldoc/html/setup.rb:11:inblock in init' 35: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/templates/default/fulldoc/html/setup.rb:68:in serialize_file' 34: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/templates/default/fulldoc/html/setup.rb:51:inserialize_index' 33: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/templates/engine.rb:121:in with_serializer' 32: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/logging.rb:82:incapture' 31: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/templates/engine.rb:123:in block in with_serializer' 30: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/templates/default/fulldoc/html/setup.rb:52:inblock in serialize_index' 29: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/templates/template.rb:136:in run' 28: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/templates/template.rb:255:inrun' 27: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/templates/template.rb:398:in add_options' 26: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/templates/template.rb:256:inblock in run' 25: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/templates/template.rb:256:in each' 24: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/templates/template.rb:259:inblock (2 levels) in run' 23: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/templates/template.rb:367:in render_section' 22: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/templates/default/layout/html/setup.rb:62:inlayout' 21: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/templates/template.rb:287:in erb' 20: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/templates/default/layout/html/layout.erb:21:in_erb_cache_5' 19: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/templates/template.rb:277:in yieldall' 18: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/templates/template.rb:412:inwith_section' 17: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/templates/template.rb:277:in block in yieldall' 16: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/templates/template.rb:255:inrun' 15: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/templates/template.rb:398:in add_options' 14: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/templates/template.rb:256:inblock in run' 13: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/templates/template.rb:256:in each' 12: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/templates/template.rb:259:inblock (2 levels) in run' 11: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/templates/template.rb:367:in render_section' 10: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/templates/default/layout/html/setup.rb:67:indiskfile' 9: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/templates/helpers/html_helper.rb:67:in htmlify' 8: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/templates/helpers/html_helper.rb:220:inresolve_links' 7: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/templates/helpers/html_helper.rb:220:in gsub' 6: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/templates/helpers/html_helper.rb:248:inblock in resolve_links' 5: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/templates/helpers/base_helper.rb:94:in linkify' 4: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/templates/helpers/html_helper.rb:296:inlink_object' 3: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/registry.rb:304:in resolve' 2: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/registry_resolver.rb:90:inlookup_by_path' 1: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/registry_resolver.rb:90:in new' /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/code_objects/proxy.rb:62:ininitialize': constant mapping (YARD::Parser::UndocumentableError)

Expected Output

I expected the html docs to be generated successfully, with warnings about issues in my own YARD syntax.

Environment details:

I have read the Contributing Guide. Check!

Thanks much! -Chris

lsegal commented 4 years ago

Marking this as a bug per the mailing list discussion. YARD should warn about this undocumentable const but shouldn't cause a crash.