Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

CHM and related fixes #577

Merged
4 commits merged into from May 9, 2014
Merged

CHM and related fixes #577

4 commits merged into from May 9, 2014

Conversation

CyberShadow
Copy link
Member

@ghost
Copy link

ghost commented May 9, 2014

Excellent, it builds now. But I do get some warnings and errors:

$ make -f win32.mak chm
dmd chmgen
DMD v2.066 DEBUG

chmgen
Processing .\32-64-portability.html
Downloading https://ajax.googleapis.com/ajax/libs/jquery/1.7.2/jquery.min.js to chm/js/jquery.min.js...
Warning: Page not found in navigation
Processing .\abi.html
Processing .\acknowledgements.html
Processing .\appendices.html
Warning: Page not found in navigation
Processing .\arrays.html
Processing .\articles.html
Warning: Page not found in navigation
Processing .\ascii-table.html
Processing .\attribute.html
Processing .\bugstats.php.html
Warning: Page not found in navigation
Processing .\builtin.html
Processing .\changelog.html
Processing .\class.html
Processing .\code_coverage.html
Processing .\COM.html
Warning: Page not found in navigation
Processing .\comparison.html
Processing .\concepts.html
Warning: Page not found in navigation
Processing .\const-faq.html
Processing .\const3.html
Processing .\contracts.html
Processing .\cppcontracts.html
Warning: Page not found in navigation
Processing .\cppstrings.html
Warning: Page not found in navigation
Processing .\cpptod.html
Processing .\cpp_interface.html
Processing .\css\codemirror.css
Processing .\css\ddox.css
Processing .\css\html-skeleton.css
Processing .\css\print.css
Processing .\css\style.css
Processing .\ctod.html
Processing .\d-array-article.html
Processing .\d-floating-point.html
Processing .\D1toD2.html
Warning: Page not found in navigation
Processing .\dcompiler.html
Warning: Page not found in navigation
Processing .\ddoc.html
Processing .\debugger.html
Warning: Page not found in navigation
Processing .\declaration.html
Processing .\deprecate.html
Warning: Page not found in navigation
Copying .\dlangspec.png
Processing .\dll-linux.html
Warning: Page not found in navigation
Processing .\dll.html
Warning: Page not found in navigation
Processing .\dmd-freebsd.html
Processing .\dmd-linux.html
Processing .\dmd-osx.html
Processing .\dmd-windows.html
Processing .\download.html
Processing .\dstyle.html
Processing .\ebook.css
Processing .\entity.html
Processing .\enum.html
Processing .\errors.html
Processing .\exception-safe.html
Processing .\expression.html
Processing .\faq.html
Copying .\favicon.ico
Processing .\features2.html
Processing .\float.html
Processing .\function.html
Processing .\garbage.html
Processing .\glossary.html
Processing .\grammar.html
Processing .\hash-map.html
Processing .\hijack.html
Processing .\howto-promote.html
Warning: Page not found in navigation
Processing .\howtos.html
Warning: Page not found in navigation
Processing .\htod.html
Processing .\htomodule.html
Warning: Page not found in navigation
Processing .\iasm.html
Copying .\images\c1.gif
Copying .\images\cpp1.gif
Copying .\images\d002.ico
Copying .\images\d3.png
Copying .\images\d4.gif
Copying .\images\d5.gif
Copying .\images\ddox\alias.png
Copying .\images\ddox\class.png
Copying .\images\ddox\enum.png
Copying .\images\ddox\enummember.png
Copying .\images\ddox\function.png
Copying .\images\ddox\inherited.png
Copying .\images\ddox\interface.png
Copying .\images\ddox\module.png
Copying .\images\ddox\package.png
Copying .\images\ddox\private.png
Copying .\images\ddox\property.png
Copying .\images\ddox\protected.png
Copying .\images\ddox\struct.png
Copying .\images\ddox\template.png
Copying .\images\ddox\tree-item-closed.png
Copying .\images\ddox\tree-item-open.png
Copying .\images\ddox\variable.png
Copying .\images\debian_logo.png
Copying .\images\dlogo.png
Copying .\images\dmlogo-smaller.gif
Copying .\images\dmlogo.gif
Copying .\images\download.png
Copying .\images\fedora_logo.png
Copying .\images\freebsd_logo.png
Copying .\images\gentoo_logo.png
Copying .\images\github-ribbon.png
Copying .\images\globe.gif
Copying .\images\gradient-green.jpg
Copying .\images\gradient-red.jpg
Copying .\images\linux_logo.png
Copying .\images\mac_logo.png
Copying .\images\opensuse_logo.png
Copying .\images\original\debian_logo.png
Copying .\images\original\fedora_logo.png
Copying .\images\original\freebsd_logo.png
Copying .\images\original\linux_logo.png
Copying .\images\original\mac_logo.png
Copying .\images\original\opensuse_logo.png
Copying .\images\original\ubuntu_logo.png
Copying .\images\original\win32_logo.png
Copying .\images\pen.gif
Copying .\images\quote.gif
Copying .\images\search-bg.gif
Copying .\images\search-button.gif
Copying .\images\search-left.gif
Copying .\images\tdpl.jpg
Copying .\images\ubuntu_logo.png
Copying .\images\win32_logo.png
Processing .\index.html
Processing .\interface.html
Processing .\interfaceToC.html
Processing .\intro-to-datetime.html
Processing .\intro.html
Copying .\js\codemirror-compressed.js
Copying .\js\ddox.js
Copying .\js\run-main-website.js
Copying .\js\run.js
Processing .\language-reference.html
Warning: Page not found in navigation
Processing .\lazy-evaluation.html
Processing .\lex.html
Processing .\memory-safe-d.html
Processing .\memory.html
Processing .\migrate-to-shared.html
Processing .\mixin.html
Processing .\module.html
Processing .\operatoroverloading.html
Processing .\overview.html
Processing .\phobos\ast.html
Warning: Page not found in navigation
Processing .\phobos\core_atomic.html
Processing .\phobos\core_bitop.html
Processing .\phobos\core_cpuid.html
Processing .\phobos\core_exception.html
Processing .\phobos\core_memory.html
Processing .\phobos\core_runtime.html
Processing .\phobos\core_simd.html
Processing .\phobos\core_sync_barrier.html
Processing .\phobos\core_sync_condition.html
Processing .\phobos\core_sync_config.html
Processing .\phobos\core_sync_exception.html
Processing .\phobos\core_sync_mutex.html
Processing .\phobos\core_sync_rwmutex.html
Processing .\phobos\core_sync_semaphore.html
Processing .\phobos\core_thread.html
Processing .\phobos\core_time.html
Processing .\phobos\core_vararg.html
Processing .\phobos\entities.html
Warning: Page not found in navigation
Processing .\phobos\etc_c_curl.html
Processing .\phobos\etc_c_sqlite3.html
Processing .\phobos\etc_c_zlib.html
Processing .\phobos\index.html
Warning: Page not found in navigation
Processing .\phobos\lexer.html
Warning: Page not found in navigation
Processing .\phobos\object.html
Processing .\phobos\parser.html
Warning: Page not found in navigation
Processing .\phobos\std_algorithm.html
Processing .\phobos\std_array.html
Processing .\phobos\std_ascii.html
Processing .\phobos\std_base64.html
Processing .\phobos\std_bigint.html
Processing .\phobos\std_bitmanip.html
Processing .\phobos\std_compiler.html
Processing .\phobos\std_complex.html
Processing .\phobos\std_compression_lz77.html
Warning: Page not found in navigation
Processing .\phobos\std_concurrency.html
Processing .\phobos\std_container.html
Processing .\phobos\std_conv.html
Processing .\phobos\std_cstream.html
Processing .\phobos\std_csv.html
Processing .\phobos\std_c_fenv.html
Warning: Page not found in navigation
Processing .\phobos\std_c_locale.html
Warning: Page not found in navigation
Processing .\phobos\std_c_math.html
Warning: Page not found in navigation
Processing .\phobos\std_c_process.html
Warning: Page not found in navigation
Processing .\phobos\std_c_stdarg.html
Warning: Page not found in navigation
Processing .\phobos\std_c_stddef.html
Warning: Page not found in navigation
Processing .\phobos\std_c_stdio.html
Warning: Page not found in navigation
Processing .\phobos\std_c_stdlib.html
Warning: Page not found in navigation
Processing .\phobos\std_c_string.html
Warning: Page not found in navigation
Processing .\phobos\std_c_time.html
Warning: Page not found in navigation
Processing .\phobos\std_c_wcharh.html
Warning: Page not found in navigation
Processing .\phobos\std_datetime.html
Processing .\phobos\std_demangle.html
Warning: Page not found in navigation
Processing .\phobos\std_digest_crc.html
Processing .\phobos\std_digest_digest.html
Processing .\phobos\std_digest_md.html
Processing .\phobos\std_digest_ripemd.html
Processing .\phobos\std_digest_sha.html
Processing .\phobos\std_encoding.html
Processing .\phobos\std_exception.html
Processing .\phobos\std_file.html
Processing .\phobos\std_format.html
Processing .\phobos\std_functional.html
Processing .\phobos\std_gc.html
Warning: Page not found in navigation
Processing .\phobos\std_getopt.html
Processing .\phobos\std_json.html
Processing .\phobos\std_math.html
Processing .\phobos\std_mathspecial.html
Processing .\phobos\std_md5.html
Warning: Page not found in navigation
Processing .\phobos\std_metastrings.html
Warning: Page not found in navigation
Processing .\phobos\std_mmfile.html
Processing .\phobos\std_net_curl.html
Processing .\phobos\std_net_isemail.html
Processing .\phobos\std_numeric.html
Processing .\phobos\std_outbuffer.html
Processing .\phobos\std_parallelism.html
Processing .\phobos\std_path.html
Processing .\phobos\std_process.html
Processing .\phobos\std_random.html
Processing .\phobos\std_range.html
Processing .\phobos\std_regex.html
Processing .\phobos\std_signals.html
Processing .\phobos\std_socket.html
Processing .\phobos\std_socketstream.html
Processing .\phobos\std_stdint.html
Warning: Page not found in navigation
Processing .\phobos\std_stdio.html
Processing .\phobos\std_stream.html
Processing .\phobos\std_string.html
Processing .\phobos\std_system.html
Processing .\phobos\std_thread.html
Warning: Page not found in navigation
Processing .\phobos\std_traits.html
Processing .\phobos\std_typecons.html
Processing .\phobos\std_typetuple.html
Processing .\phobos\std_uni.html
Processing .\phobos\std_uri.html
Processing .\phobos\std_utf.html
Processing .\phobos\std_uuid.html
Processing .\phobos\std_variant.html
Processing .\phobos\std_windows_charset.html
Processing .\phobos\std_windows_registry.html
Warning: Page not found in navigation
Processing .\phobos\std_xml.html
Processing .\phobos\std_zip.html
Processing .\phobos\std_zlib.html
Processing .\portability.html
Processing .\pragma.html
Processing .\pretod.html
Processing .\prettify\prettify.css
Copying .\prettify\prettify.js
Processing .\property.html
Processing .\rationale.html
Processing .\rdmd.html
Processing .\regular-expression.html
Processing .\safed.html
Processing .\simd.html
Processing .\spec.html
Warning: Page not found in navigation
Processing .\statement.html
Processing .\struct.html
Processing .\template-comparison.html
Warning: Page not found in navigation
Processing .\template-mixin.html
Processing .\template.html
Processing .\templates-revisited.html
Processing .\traits.html
Processing .\tuple.html
Processing .\type.html
Processing .\unittest.html
Processing .\variadic-function-templates.html
Processing .\version.html
Processing .\warnings.html
Processing .\wc.html
Processing .\windbg.html
Processing .\windows.html
Warning: Page not found in navigation

cmd /C ""C:\Program Files (x86)\HTML Help Workshop\hhc.exe" d.hhp"
Microsoft HTML Help Compiler 4.74.8702



Compiling c:\dmd-git\dmd2\src\dlang.org\d.chm



HHC5013: Error: URL reference in the TOC cannot be resolved: "chm\phobos\std_contracts.html".

HHC5013: Error: URL reference in the TOC cannot be resolved: "chm\phobos\std_cpuid.html".

HHC5013: Error: URL reference in the TOC cannot be resolved: "chm\phobos\std_ctype.html".

HHC5013: Error: URL reference in the TOC cannot be resolved: "chm\phobos\std_date.html".

HHC5013: Error: URL reference in the TOC cannot be resolved: "chm\phobos\std_gregorian.html".

HHC5013: Error: URL reference in the TOC cannot be resolved: "chm\phobos\std_regexp.html".

HHC5013: Error: URL reference in the TOC cannot be resolved: "chm\phobos\phobos.html#std_windows".

HHC5013: Error: URL reference in the TOC cannot be resolved: "chm\phobos\phobos.html#std_linux".

HHC5013: Error: URL reference in the TOC cannot be resolved: "chm\phobos\phobos.html#std_c_windows".

HHC5013: Error: URL reference in the TOC cannot be resolved: "chm\phobos\phobos.html#std_c_linux".

HHC5013: Error: URL reference in the TOC cannot be resolved: "chm\phobos\core_demangle.html".





The following files were not compiled:

@ghost
Copy link

ghost commented May 9, 2014

Btw, the makefile's clean target includes:

if exist phobos rmdir /S /Q phobos

I think this is unnecessary, it makes it hard to do a clean build of chm without having to copy all of those phobos html files all over again.

Actually it would be nice if chmgen looked for the Phobos HTML files in a path specified by an environment variable so we didn't have to copy the files around.

@CyberShadow
Copy link
Member Author

They sort of have to be there for the site structure to actually work when on your hard drive.

I suggest using a symlink / directory junction, or overriding the DOC variable when building Phobos/Druntime docs.

@CyberShadow
Copy link
Member Author

I'm not sure what is the cause for those error messages, but I suspect stale .html files in your checkout (probably which no longer correspond to a .dd file). Try using git clean.

The warnings are more or less expected. I think they all indicate valid (albeit minor) issues with the documentation, whether it's orphaned pages which are no longer reachable via navigation, redirect pages that really should be redone as a HTTP 30x redirect, or other such things.

ghost pushed a commit that referenced this pull request May 9, 2014
@ghost ghost merged commit 3bccab2 into dlang:master May 9, 2014
This pull request was closed.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
1 participant